Debian环境下如何调试Tomcat应用

Debian环境下调试Tomcat应用的步骤

1. 准备工作：安装必要工具

确保系统中已安装Java JDK（建议OpenJDK 11及以上）和Tomcat（如Tomcat 9/10）。若未安装，可通过以下命令安装：

sudo apt update
sudo apt install openjdk-11-jdk tomcat9

安装完成后，确认Java环境变量JAVA_HOME已正确设置（通常位于/usr/lib/jvm/java-11-openjdk-amd64）。

2. 配置Tomcat启用远程调试

Tomcat支持两种方式开启远程调试：

• 方式一：修改catalina.sh（推荐）
  打开Tomcat的bin目录下的catalina.sh文件，末尾添加以下参数：

  export CATALINA_OPTS="$CATALINA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005"
  

  其中，address=5005为调试端口（可根据需求修改），suspend=n表示Tomcat启动时不暂停（若需调试启动过程，可设为y）。

• 方式二：使用setenv.sh（更规范）
  在bin目录下创建setenv.sh文件（若不存在），添加以下内容：

  export JPDA_OPTS="-agentlib:jdwp=transport=dt_socket,address=5005,server=y,suspend=n"
  

  此方式可将调试配置与主脚本分离，便于维护。

3. 启动Tomcat调试模式

• 方法一：通过startup.sh启动
  执行以下命令启动Tomcat，自动加载调试配置：

  /path/to/tomcat/bin/startup.sh
  

• 方法二：使用jpda命令（更直观）
  若使用setenv.sh，可直接运行：

  /path/to/tomcat/bin/catalina.sh jpda start
  

  启动后，通过ps aux | grep tomcat确认Tomcat进程是否携带jdwp参数。

4. 配置IDE进行远程调试

以IntelliJ IDEA为例，步骤如下：

1. 打开项目，进入Run -> Edit Configurations。
2. 点击+号，选择Remote JVM Debug。
3. 在Configuration标签页中，设置：
   • Host：Tomcat服务器的IP地址（本地调试可填localhost）；
   • Port：与Tomcat配置中的address一致（如5005）。
4. 点击Apply保存配置。
5. 点击工具栏的Debug按钮（绿色虫子图标），启动远程调试。此时IDE会连接到Tomcat，等待断点触发。

5. 设置断点与调试操作

• 设置断点：在代码行号左侧点击，添加断点（红色圆点）。
• 调试流程：
  • 当代码执行到断点时，程序会暂停，IDE显示当前变量值、调用栈等信息；
  • 使用调试工具栏的按钮（如Step Over、Step Into、Resume Program）控制执行流程；
  • 观察变量变化，定位问题根源（如空指针、逻辑错误）。

6. 辅助调试：日志分析与端口检查

• 查看实时日志：通过tail -f /var/log/tomcat9/catalina.out命令实时查看Tomcat日志，快速定位错误（如ERROR关键字）。
• 检查端口占用：使用ss -tuln | grep 5005确认调试端口未被其他进程占用（若被占用，可修改address参数或终止占用进程）。
• 调整日志级别：若需更详细的日志，可修改/var/log/tomcat9/conf/logging.properties文件，将对应包的日志级别设为DEBUG（如org.apache.catalina.level = DEBUG）。

通过以上步骤，可在Debian环境下高效调试Tomcat应用，结合日志分析与IDE调试，快速定位并解决问题。