JSP应用在Debian上的调试方法

在 Debian 上调试 JSP 应用的高效方法

一 环境准备与快速验证

• 安装 JDK 与 Tomcat：sudo apt update && sudo apt install openjdk-11-jdk tomcat9。完成后用 java -version 验证版本。
• 启动与自启：sudo systemctl start tomcat9 && sudo systemctl enable tomcat9。
• 访问测试：打开浏览器访问 http://服务器IP:8080，看到 Tomcat 欢迎页即表示运行正常。
• 防火墙放行：如启用防火墙，放行 8080/tcp（例如 sudo ufw allow 8080/tcp）。
• 部署应用：将应用打包为 WAR 并复制到 /var/lib/tomcat9/webapps/，Tomcat 会自动解压部署，访问 http://IP:8080/应用名。
  以上步骤可快速建立可调试的运行时环境。

二 日志定位与问题排查

• Tomcat 日志：重点关注 /var/log/tomcat9/catalina.out（实时输出）与 localhost.<日期>.log（应用级日志）。实时查看可用：tail -f /var/log/tomcat9/catalina.out；按关键字筛选：cat … | grep “error”。
• 系统服务日志：若通过 systemd 管理 Tomcat，使用 journalctl -u tomcat9 查看启动与运行日志。
• 反向代理日志：若前置 Apache/Nginx，同时检查 /var/log/apache2/ 或 /var/log/nginx/ 的访问与错误日志，以定位前端到后端的转发与协议问题。
• 常见检查：JSP 语法与 EL 表达式、应用是否成功部署（webapps 是否解压）、数据库连接与 JDBC 驱动、文件与目录权限（Tomcat 运行用户对相关目录的读写权限）。

三 远程调试与 IDE 联动

• 方式 A（推荐，保持系统服务）：在 /etc/default/tomcat9 的 JAVA_OPTS 中追加调试参数，例如：
  JAVA_OPTS=“$JAVA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005”
  重启服务：sudo systemctl restart tomcat9。在 IntelliJ IDEA/Eclipse 创建远程调试配置，主机填服务器 IP，端口 5005，即可断点调试。
• 方式 B（手动脚本启动）：在 catalina.sh run 前设置 CATALINA_OPTS 为同样的 JDWP 参数，前台运行便于观察输出。
• 连接要点：确保服务器防火墙放行 5005/tcp；IDE 与服务器时间同步；如为云主机，安全组需放通端口。
• 适用场景：断点、单步、变量观察、热替换受限（JSP 本质运行在容器，类加载后热替换有限，建议小步提交与重启配合）。

四 命令行与低层工具

• JDB：JDK 自带命令行调试器，可在目标 JVM（Tomcat）上以调试代理方式连接，执行断点、栈帧与变量查看，适合无图形界面的服务器环境。
• System.out.println：在 JSP/Servlet 中临时打印变量与执行流，快速验证分支与数据；上线前清理或改为日志框架输出。
• 浏览器开发者工具：F12 检查 Console 与 Network，定位前端资源加载、AJAX 请求与响应状态，配合后端日志交叉验证。

五 进阶配置与常见坑

• 日志级别调优：编辑 conf/logging.properties，将 1catalina.org.apache.juli.AsyncFileHandler.level 调为 FINE/ALL 以获取更详细输出，便于问题定位。
• 前端代理与端口：若使用 Apache + mod_jk 或 Nginx 反向代理，确保代理规则与后端 8080 一致，并分别检查 Apache/Nginx 与 Tomcat 两侧日志。
• 数据库与驱动：确认数据库可达、连接串与凭据正确，且 JDBC 驱动 JAR 位于 Tomcat 的 lib 目录（全局可用），避免 ClassNotFound 或连接失败。
• 文件权限：部署目录与日志目录对 tomcat 用户可读写（例如 chown -R tomcat:tomcat /var/lib/tomcat9 /var/log/tomcat9），避免因权限不足导致部署或写日志失败。