Java调试核心在于断点精准、变量清晰、线程可控；常见问题包括编译缺-g参数致行号丢失、Lombok未配置调试支持、Spring Boot排除关键自动配置、JIT优化干扰断点，以及远程调试地址绑定错误等。
Java 程序调试不依赖 IDE 也能做，但绝大多数实际开发中，IntelliJ IDEA 或 Eclipse 的调试能力已覆盖 95% 以上的日常需求；关键不是“能不能调”，而是“怎么让断点停得准、变量看得清、线程不乱套”。
为什么断点没生效？常见触发条件漏了
断点失效往往不是 IDE 问题，而是代码未执行到、字节码与源码不匹配，或 JVM 启动参数屏蔽了调试支持。
-
javac编译时没加-g（或 IDE 中未启用 “Generate debugging info”），会导致行号信息丢失，断点无法对齐源码行 - 使用了
lombok且未开启@Data/@Setter的delombok调试支持，IDE 可能停在生成的桥接方法而非你写的字段赋值处 - Spring Boot 应用启动类用了
@SpringBootApplication(exclude = {...})，若排除了DebugAgent相关自动配置（极少见），可能干扰调试钩子 - 运行时用了
-XX:+TieredStopAtLevel=1或-Xint强制解释执行，某些 JIT 优化绕过会干扰断点命中逻辑（尤其 lambda 内联后）
IntelliJ IDEA 中 step into 却跳进了 JDK 源码？
这是默认行为，IDEA 会把所有可调试的 class 都纳入单步范围，包括 java.util.ArrayList、String.valueOf() 这类底层调用。真正需要的是“只进自己代码”。
- 打开
Settings → Build, Execution, Deployment → Debugger → Stepping - 勾选
Do not step into the classes，并添加规则：java.*、javax.*、sun.*、com.sun.*、jdk.* - 更精细控制：点击右侧
+添加自定义包名，比如org.springframework.boot.*（避免陷入 Spring 初始化链） - 临时跳过：按
Alt + Shift + F7（Windows/Linux）或Option + Shift + F7（macOS）执行 “Force Step Into”，仅对当前调用生效
Eclipse 调试时 variables 视图里看不到局部变量？
不是变量被优化掉了，就是调试器没加载对应符号表 —— 尤其多模块 Maven 项目中，class 文件和 source folder 映射错位最常见。
立即学习“Java免费学习笔记（深入）”；
- 确认项目构建输出路径（
target/classes）是否被正确设为 “output folder”，且.classpath中<output></output>指向它 - 右键项目 →
Properties → Java Build Path → Source，检查 “Source folders on build path” 是否包含真实源码目录，而非仅 jar 包 - 如果用了
mvn compile -Dmaven.debug=true启动编译，但没配maven-compiler-plugin的<debug>true</debug>，生成的 class 仍无调试信息 - 在
Debug Configurations → Arguments → VM arguments中补上：-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005（仅远程调试需显式加）
远程调试连接不上？端口、防火墙、JVM 参数三者必须咬死
本地连不上远程 JVM，90% 是因为 address 值写成了 localhost:5005 或 127.0.0.1:5005，导致监听绑定在回环地址，外部无法访问。
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar app.jar
-
address=*:5005表示监听所有网卡（Java 8u152+ 支持；旧版本用0.0.0.0:5005） - Linux 上检查端口是否被占用：
ss -tuln | grep :5005；若显示127.0.0.1:5005，说明绑定失败，需升级 JRE 或改用0.0.0.0 - Docker 容器内启动需额外暴露端口：
docker run -p 5005:5005 ...，且 JVM 参数中address仍须为*:5005（容器内网络视角） - 云服务器务必检查安全组规则，开放 TCP 5005（或你指定的端口），不能只靠本地
iptables
调试不是按下 F9 就完事；最常卡住的地方，是以为断点该停却没停，然后怀疑 IDE 坏了——其实只是 javac 没带 -g，或者 Spring 正在用 CGLIB 动态代理绕过你的原始类。
