Debian Java代码调试有哪些方法

Debian 上常用的 Ja va 调试方法

搞定Ja va程序调试，是每个开发者的基本功。在Debian环境下，从本地到远程，从命令行到图形界面，其实有一套非常成熟的工具箱。下面，我们就来系统地梳理一遍。

一 环境准备

工欲善其事，必先利其器。调试的第一步，自然是准备好Ja va环境。

• 安装 OpenJDK 11（或你需要的版本）：直接通过包管理器搞定，命令很简单：sudo apt update && sudo apt install openjdk-11-jdk。安装完成后，别忘了用 ja va -version 和 ja vac -version 验证一下。
• 可选：设置环境变量：如果你需要管理多个Ja va版本，设置环境变量会方便很多。通常的做法是在 ~/.bashrc 文件末尾添加两行：export JA VA_HOME=/usr/lib/jvm/ja va-11-openjdk-amd64 和 export PATH=$PATH:$JA VA_HOME/bin。添加后，执行一下 source ~/.bashrc 让配置生效即可。

二 本地调试方法

本地调试是最直接的方式，主要分两种：轻量级的命令行和功能强大的图形界面。

• 使用 jdb（JDK 自带命令行调试器）
  1. 编译时务必加入调试信息：ja vac -g HelloWorld.ja va。
  2. 启动调试器：jdb HelloWorld。
  3. 接下来就是常用命令的舞台了：stop at HelloWorld:5（在指定行设置断点）、stop in YourClass.yourMethod（在方法入口设置断点）、run（运行）、step（步入）、next（步过）、continue（继续）、print var（打印变量）。
• 使用 IDE 图形化调试（IntelliJ IDEA / Eclipse / NetBeans）

  这才是大多数人的选择，毕竟可视化操作更直观。流程基本是通用的：在代码行号左侧点击设置断点，然后点击工具栏那个“小虫子”图标启动调试。之后，你就可以熟练地使用 Step Over（F8）、Step Into（F7）、Step Out、Resume（F9）以及 Evaluate Expression（计算表达式）等功能了。

三 远程调试方法

当程序跑在测试服务器甚至容器里时，远程调试就派上用场了。其核心是启用JDWP（Ja va Debug Wire Protocol）服务。

• 启动参数启用 JDWP（推荐新语法）

  启动应用时加上这个参数：ja va -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar your-app.jar。

  这里有几个关键参数需要理解：

  • transport=dt_socket：使用套接字传输。
  • server=y：让JVM作为调试服务器等待连接。
  • suspend=n：启动时不挂起，程序会直接运行。如果设为y，则会等待调试器连接后才开始执行，适合调试启动过程。
  • address=*:5005：监听所有网络接口的5005端口。如果只想本地连接，用address=5005即可。

• 兼容旧语法（部分老版本 JDK 可用）

  如果你遇到非常老旧的JDK版本，可能需要使用这个语法：ja va -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005 -jar yourapp.jar。

• IDE 连接步骤（以 IntelliJ/Eclipse 为例）

  服务端准备好了，客户端连接就很简单了。以IntelliJ为例：Run → Edit Configurations → 点击“+”号 → 选择“Remote”。然后填写远程主机的IP和端口（比如5005），连接方式选择“Attach”，最后点击Debug启动连接。

• 服务化场景
  • Tomcat：在 CATALINA_HOME/bin/setenv.sh 文件中设置 JPDA_OPTS 环境变量，然后使用 ./catalina.sh jpda start 命令启动即可。
  • Spring Boot：如果通过 spring-boot:run 运行，可以在 application.properties 中添加：spring-boot.run.jvm-arguments=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005。
• 网络与安全

  远程调试涉及网络，安全措施不能少：

  • 开放端口：如果服务器有防火墙，记得放行：sudo ufw allow 5005/tcp。
  • 更安全的访问：直接暴露调试端口有风险。更推荐使用SSH隧道：ssh -L 5005:localhost:5005 user@remote，这样调试流量就通过加密的SSH通道传输了。
  • 容器场景：在Docker中运行应用时，需要将调试端口映射出来：docker run -p 5005:5005 …。
  • 重要建议：远程调试会显著影响性能并带来安全风险，因此务必仅在测试环境启用，生产环境必须关闭。

四 附加到正在运行的 JVM

有时候，一个已经在运行的程序突然需要调试，怎么办？可以动态附加上去。

• 首先，用 jps 命令找到目标Ja va进程的PID。
• 然后，使用 jdb -attach 命令附加调试器。
• 连接成功后，你就可以像平常一样设置断点、查看变量、单步执行了。

五 辅助手段与最佳实践

掌握基本方法后，一些辅助技巧和原则能让调试事半功倍。

• 编译信息是关键：编译时加上 -g 参数生成完整的调试信息，这是后续一切断点和变量查看的基础。
• 日志与性能分析：调试不是万能的。在关键位置添加详尽的日志，往往能快速定位问题域。对于性能瓶颈，可以借助 JProfiler、YourKit 等专业工具进行深度分析。
• 远程调试注意事项：这里有几个坑需要留意：
  • 确保本地IDE的代码版本与远程服务器上的完全一致，否则断点可能对不上。
  • 当断点触发时，远程线程会被挂起，可能导致请求卡住，影响其他用户。
  • 远程应用的 System.out 和日志输出仍然在远程控制台，不会显示在本地IDE。
  • 调试本身会引入网络延迟，因此建议按需、短时开启。