Java Web应用在Ubuntu上如何调试

在 Ubuntu 上调试 Ja va Web 应用的标准流程

调试Ja va Web应用，尤其是在生产或准生产环境中，是开发者必须掌握的技能。下面这份流程，涵盖了从本地开发到远程诊断的完整路径，帮你系统化地解决问题。

一 本地开发调试 Tomcat 或嵌入式容器

一切从本地开始。在Ubuntu桌面环境下搭建一个可调试的开发环境，是最高效的起点。

• 安装环境：首先，安装指定版本的JDK（8、11或17）和Tomcat 9（或其他对应版本）。开发工具方面，Eclipse IDE for Ja va EE 或 IntelliJ IDEA 任选其一即可。
• IDE配置与部署：在IDE中配置Server Runtime，将其指向Tomcat的安装目录。接着，创建一个Dynamic Web Project，并将你的应用部署到这台本地服务器上。
• 启动调试会话：接下来，在关键的JSP页面、Servlet或业务逻辑代码中设置断点。通过“Debug As → Debug on Server”启动调试，然后在浏览器中访问对应页面来触发断点。一旦命中，你就可以自如地进行单步跟踪、观察变量和计算表达式了。
• 查看运行日志与问题定位：别忘了日志这个好帮手。Tomcat的日志通常位于 /var/log/tomcat9/catalina.out。将断点调试信息与日志中的错误记录结合起来分析，往往能更快地锁定问题根源。

二 远程调试 Tomcat 或任意 Ja va Web 服务

当问题出现在远程服务器上时，远程调试就成了“救火队长”。其核心是让JVM开启调试端口，允许IDE通过网络连接进来。

• 在 Ubuntu 服务器上启用调试参数
  • 方式一（推荐，不改动启动脚本）：在Tomcat的环境变量CATALINA_OPTS中设置。例如，在/usr/share/tomcat9/bin/catalina.sh文件中，找一个合适的位置（通常放在其他JA VA_OPTS设置之后更稳妥）添加：

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

    这里有几个关键点：
    • address 端口可以自定义，比如5005。强烈建议写成 address=*:5005 来监听所有网络接口，避免只绑定127.0.0.1导致外部无法连接。
    • suspend=n 表示应用启动时不等待调试器连接；如果需要调试启动过程，可以改为 suspend=y，让JVM启动后暂停，直到调试器接入。
  • 方式二（传统参数，兼容旧版本）：

    CATALINA_OPTS="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005"

  • 重启 Tomcat 生效：

    sudo systemctl restart tomcat9

• 在 IDE 中创建远程调试配置
  • IntelliJ IDEA：打开“Run/Debug Configurations”，添加一个“Remote JVM Debug”。填写服务器IP地址和端口（如5005），选择对应的源码模块，然后点击Debug按钮即可连接。
  • Eclipse：在“Debug Configurations”中创建“Remote Ja va Application”配置。同样填入Host（服务器IP）和Port（5005），并关联本地项目源码，随后启动Debug。
• 连接与验证
  • 连接前，可以在服务器上确认调试端口是否已成功监听：

    ss -lntp | grep 5005

  • 当本地IDE成功连接并命中断点后，你会发现，其调试体验——查看变量、调用堆栈、计算表达式——与本地调试几乎毫无二致。

三 命令行与进阶工具

并非所有环境都允许使用图形化IDE。掌握命令行工具和系统级诊断方法，能让你在更复杂的情况下游刃有余。

• 使用 JDB 进行命令行调试（无需图形界面）：对于无GUI的服务器或喜欢命令行的开发者，JDB是标准选择。

  # 连接远程调试端口
  jdb -attach <服务器IP>:5005
  
  # 常用命令示例
  stop in com.example.MyServlet.doGet  # 在方法处设置断点
  cont                                 # 继续执行
  step                                 # 单步步入
  next                                 # 单步步过
  print myVariable                     # 打印变量值

• 进阶排查工具（定位系统层面或本地开发环境问题）：有些问题超出了Ja va层面，需要更底层的工具。
  • strace：跟踪进程的系统调用，非常适合分析应用启动失败、类加载异常、或文件/网络访问等底层问题。
  • GDB：主要用于调试JVM本身或应用调用的本地原生（Native）库。对于纯Ja va应用，优先使用JDWP/JDB或IDE。
  • Valgrind：强大的内存错误检测工具，多用于C/C++等原生代码。Ja va应用的内存问题，通常优先依靠GC日志和堆转储（Heap Dump）分析。

四 常见问题与排查清单

调试过程不会总是一帆风顺。遇到连接失败或断点不生效时，可以按照下面这个清单逐一核对。

• 端口与防火墙
  • 确认服务器的8080（应用端口）和5005（调试端口）既没有被其他进程占用，也未被防火墙阻拦：

    sudo ufw allow 8080,5005/tcp
    ss -lntp | egrep ':(8080|5005)'

• 监听地址
  • 这是远程连接失败的常见原因。务必确保调试参数中的地址设置为 address=*:5005 或 address=0.0.0.0:5005，如果只绑定了127.0.0.1，外部机器自然无法连接。
• 版本与兼容性
  • 检查JDK版本与Tomcat版本是否兼容。另外，调试JSP时，需要确保容器正确部署了JSP文件，且与源码匹配。
• 日志优先
  • 如果断点始终无法命中，别急着怀疑调试配置。首先去查看 catalina.out 和 localhost.<日期>.log 等日志文件，确认应用本身是否已成功部署且没有抛出任何启动异常。
• 远程代码一致性
  • 这是最关键的陷阱之一：远程服务器上运行的class文件，必须与本地IDE中打开的源代码版本完全一致（来自同一次构建）。否则，断点位置会错乱，导致调试行为异常或完全失效。