Debian Java代码调试有哪些方法
Debian 上常用的 Ja va 调试方法 搞定Ja va程序调试,是每个开发者的基本功。在Debian环境下,从本地到远程,从命令行到图形界面,其实有一套非常成熟的工具箱。下面,我们就来系统地梳理一遍。 一 环境准备 工欲善其事,必先利其器。调试的第一步,自然是准备好Ja va环境。 安装 Op
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 自带命令行调试器)
- 编译时务必加入调试信息:
ja vac -g HelloWorld.ja va。 - 启动调试器:
jdb HelloWorld。 - 接下来就是常用命令的舞台了:
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。
- Tomcat:在
- 网络与安全
远程调试涉及网络,安全措施不能少:
- 开放端口:如果服务器有防火墙,记得放行:
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。 - 调试本身会引入网络延迟,因此建议按需、短时开启。


































