jdb 是 JDK 自带的轻量级命令行调试器,适合快速定位问题但功能有限;常见错误包括类路径配置不当、主类名未用全限定名、run 命令重复执行失败需先 kill、断点失效因方法未调用或位置不可达、局部变量类型不显示且 toString() 输出不直观。

jdb 是 JDK 自带的命令行调试器,能断点、单步、查变量,但默认不支持语法高亮、不记历史命令、不能图形化查看栈帧——它适合快速定位问题,不适合日常主力调试。
启动 jdb 时类路径和主类名总报 NoClassDefFoundError
常见错误是没传对 -classpath 或主类名写错(比如带 .class 后缀、包路径用反斜杠、没加完整包名)。jdb 不会自动从当前目录加载 class,必须显式指定。
- 确保编译后的
.class文件在-classpath指向的目录下,例如:jdb -classpath ./bin com.example.Main - 主类名必须是全限定名(含包),且不能带
.class;如果类在src/com/example/Main.java,运行的是com.example.Main,不是Main.class - 若依赖第三方 jar,把它们也加进
-classpath,用:(Linux/macOS)或;(Windows)分隔
run 命令失败后,run 再次执行仍报错
jdb 的 run 只在未启动或已退出状态才有效。如果上次运行崩溃(比如抛了未捕获异常)、或程序卡在断点上,jdb 仍认为 VM 处于“运行中”状态,再次 run 就会提示 VM is already running。
- 先用
kill强制终止当前 VM:kill(回车确认) - 再用
run重新启动,或加参数传参:run arg1 arg2 - 注意:每次
kill后,所有断点仍保留,无需重设
设置断点后程序直接退出,没停在 breakpoint
断点没生效,通常是因为目标方法根本没被调用,或者断点位置不可达(比如设在 private static final 字段初始化行、或内联后的代码行)。jdb 对字节码层面的断点支持有限,尤其对 lambda、try-with-resources、某些泛型桥接方法。
立即学习“Java免费学习笔记(深入)”;
- 优先在方法第一行(如
public void foo() {的左大括号下一行)设断点:stop in com.example.Service.process - 避免设在字段声明、注解、空行、或
return后面的不可达行 - 用
list查看当前源码上下文,确认行号是否匹配实际编译后的字节码位置 - 如果用了 Lombok,确保编译时开启了
-parameters且 jdb 加载的是带调试信息的 class(即编译时用了javac -g)
真正麻烦的是:jdb 不显示局部变量类型,print 输出对象时默认调用 toString(),而很多类没重写它——你看到的可能只是 com.example.User@3a71f4dd。这时候得靠 dump 看字段值,或者提前在代码里加日志。它不是不好用,是得知道它在哪卡住、怎么绕过去。










