JSP在CentOS上如何进行调试

在 CentOS 上调试 JSP 的实用流程

一环境准备与快速验证

安装 JDK 8（或更高版本）并配置环境变量，验证命令：java -version。示例：
- 安装：sudo yum install -y java-1.8.0-openjdk
- 配置：export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk；export PATH=$PATH:$JAVA_HOME/bin
安装 Tomcat 9（或你使用的版本），启动并验证：
- 安装：sudo yum install -y tomcat
- 启动/开机自启：systemctl start tomcat；systemctl enable tomcat
- 访问测试：http://服务器IP:8080
部署最简 test.jsp 验证环境（放到 webapps/ROOT 或自定义目录）：
- 代码示例：
```
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html><body>
<h1>Hello, JSP on CentOS</h1>
<%= "Server: " + application.getServerInfo() %>
</body></html>
```
- 访问：http://服务器IP:8080/test.jsp 以上步骤确保运行环境可用，是后续断点调试与日志排查的前提。

二远程断点调试 Tomcat 中的 JSP

开启 Tomcat 远程调试
- 编辑 bin/catalina.sh，在文件靠前位置加入（端口可按需改为 8000）：
```
CATALINA_OPTS="$CATALINA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000"
```
- 重启 Tomcat：systemctl restart tomcat
- 开放防火墙端口（若启用 firewalld）：firewall-cmd --add-port=8000/tcp --permanent && firewall-cmd --reload
在 IDE 中远程调试（以 IntelliJ IDEA 为例）
- Run/Debug Configurations → 新建 Remote JVM Debug
- Host：服务器IP；Port：8000；Transport：Socket
- 将断点打在 JSP 编译后的 Servlet 源码（运行一次后会在 work/Catalina/… 生成）或你自己的 Java Bean/Filter/Servlet 上
- 浏览器访问触发断点：http://服务器IP:8080/your-app/page.jsp
命令行方式使用 jdb 附加调试
- 在服务器上执行：jdb -attach 服务器IP:8000
- 常用命令：stop in 全类名.方法名；cont；step；print 变量说明：JSP 在运行期会被容器编译为 Servlet，因此断点通常落在生成的 *_jsp.java 的 _jspService 方法中；远程调试依赖 JDWP，与调试普通 Java 程序思路一致。

三日志与输出增强

打开 JSP/Servlet 容器日志
- 修改 conf/logging.properties，提升相关包日志级别（开发环境建议），例如：
```
org.apache.jasper.servlet.JspServlet.level = FINE
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = FINE
```
- 重启后在 logs/catalina.out 观察请求分发、JSP 编译与异常堆栈

打开 EL 表达式解析日志（Tomcat 专用）

在 conf/logging.properties 增加：

org.apache.jasper.el.level = FINE
org.apache.el.level = FINE
org.apache.jasper.el.handlers = 1catalina.org.apache.juli.AsyncFileHandler
org.apache.el.handlers = 1catalina.org.apache.juli.AsyncFileHandler

级别含义：FINEST < FINER < FINE < INFO < WARNING < SEVERE；FINER/FINEST 日志量很大，生产请恢复为 INFO

应用内日志

使用 Log4j/Logback 输出业务日志到文件（便于归档与分析），示例 Log4j 配置片段：

log4j.rootLogger=INFO, file
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=/var/log/jsp/myapp.log
log4j.appender.file.MaxFileSize=10MB
log4j.appender.file.MaxBackupIndex=10
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

建议将日志目录（如 /var/log/jsp）加入 logrotate 做按日轮转与保留策略，避免磁盘被占满

浏览器与网络层排查
- 使用浏览器开发者工具查看 请求/响应头、状态码与响应内容
- 必要时在响应头中关闭缓存（如 Cache-Control: no-cache）以避免旧输出干扰
- 通过 curl -v 查看原始 HTTP 往返，辅助定位网关/代理/负载均衡引入的问题以上手段可显著提升问题定位效率，尤其是 EL 日志 能直接看到表达式解析过程与作用域解析链。

四常见问题与排查清单

404 或无法访问
- 确认 Tomcat 已启动（systemctl status tomcat）、应用已部署（webapps 下是否有解压目录或 WAR 已解包）、访问路径是否正确（ROOT 应用可直接用 /，其他应用需加 /应用名）
端口与防火墙
- 8080（HTTP）与 8000（JDWP）需在云安全组/本机防火墙放行；firewall-cmd --list-ports 可核对
类找不到或依赖缺失
- 第三方 JAR 放入 WEB-INF/lib；重启后查看 catalina.out 的 ClassNotFound/NoClassDefFoundError
JSP 编译错误
- 查看 work/Catalina/… 下对应 *_jsp.java 的错误提示；修正后触发热编译或重启
页面缓存导致“改了不生效”
- 浏览器强制刷新（如 Ctrl+Shift+R 或禁用缓存），或在响应头加入 Cache-Control: no-cache, no-store
日志过多或过少
- 开发阶段可把 Jasper/EL 调到 FINE/FINER，上线前恢复 INFO；业务日志按级别与滚动策略管理以上检查点覆盖了部署、网络、编译与运行期最常见的故障面。

最新问答

相关标签