Debian系统下JSP如何进行调试

Debian下JSP调试实操指南

一 环境准备与快速验证

• 安装 JDK（推荐 OpenJDK 11）：sudo apt update && sudo apt install openjdk-11-jdk；验证：java -version、javac -version。
• 安装 Tomcat 9（两种常见方式）：
  • 包管理：sudo apt install tomcat9（配置与日志路径遵循 Debian 打包约定）。
  • 二进制包：下载解压至 /opt/tomcat，创建专用用户与权限，并通过 systemd 管理服务。
• 快速自检：
  • 包管理：sudo systemctl start tomcat9；访问 http://服务器IP:8080。
  • 二进制：/opt/tomcat/bin/startup.sh；访问 http://服务器IP:8080。

二 启用远程调试

• 方式A 包管理 Tomcat 9（/etc/default/tomcat9）
  在 /etc/default/tomcat9 中追加：
  JAVA_OPTS=“$JAVA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005”
  重启：sudo systemctl restart tomcat9。
• 方式B 二进制 Tomcat（setenv.sh 或 systemd 服务）
  • 在 $CATALINA_BASE/bin/setenv.sh 写入：
    export CATALINA_OPTS=“$CATALINA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005”
  • 或编辑 /etc/systemd/system/tomcat.service，在 Environment 或 ExecStart 前加入同等 -agentlib:jdwp=… 参数；执行 sudo systemctl daemon-reload && sudo systemctl restart tomcat。
• 连接调试
  在 IntelliJ IDEA/Eclipse 创建“Remote JVM Debug”配置，主机填服务器 IP，端口 5005，部署应用后启动调试会话。

三 日志与常见问题定位

• 查看日志
  • 包管理：/var/log/tomcat9/catalina.out、localhost.yyyy-MM-dd.log。
  • 二进制：/opt/tomcat/logs/catalina.out。
• 提高日志级别
  编辑 conf/logging.properties，将相关 .level 调整为 FINE/ALL，便于排查。
• 常见问题速查
  • 端口占用：lsof -iTCP:8080/5005；必要时更换端口或释放占用。
  • 防火墙：sudo ufw allow 8080,5005/tcp；云主机需放行安全组。
  • 部署与权限：确认应用已放入 webapps，Tomcat 用户对目录有读写权限。
  • JDBC 驱动：将数据库驱动放入 $CATALINA_HOME/lib。
  • 前端侧：浏览器开发者工具（F12）查看 Console/Network 报错与响应。

四 不依赖IDE的调试手段

• System.out.println() 输出到 catalina.out，快速定位执行流与变量。
• JDB 命令行调试：jdb -attach 服务器IP:5005，支持断点、单步、打印变量。
• 代码审查：检查 JSP 语法、EL 表达式与脚本片段；必要时拆分复杂逻辑到 Servlet 便于断点调试。

五 进阶与替代方案

• 前端与网络：使用浏览器开发者工具定位 JS/CSS/网络 问题，配合后端日志交叉验证。
• 应用服务器替代：在 Resin 上部署以获得更友好的调试特性（适合特定场景）。
• 技术选型：传统 JSP 已逐步被 Servlet/Java EE/Spring Boot + 前端框架 替代，新项目建议评估更现代的技术栈。