Java远程调试需JVM启动时添加-agentlib:jdwp参数，IDEA仅连接不启动JVM；常见错误是未加参数或配置不匹配；本地调试可用Attach to Process，但受JDK版本限制；务必确保源码与远端字节码一致。
Java远程调试时，java命令必须加-agentlib:jdwp参数
IDEA本身不启动JVM，它只连接已运行的JVM进程。所以远程调试的前提是目标JVM以调试模式启动——不是IDEA点“Debug”就自动生效，而是你得手动加JDWP代理参数。
常见错误现象：Connection refused 或 IDEA提示 Unable to connect to target VM，大概率是没加参数，或参数写错位置（比如加在java -jar xxx.jar后面而不是前面）。
-
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005是JDK 8及以前的标准写法；JDK 9+ 推荐用address=5005（去掉*:），否则可能因IPv6绑定失败 -
suspend=y会让JVM启动后卡住，等IDEA连上才继续执行，适合调试启动逻辑；日常用suspend=n更顺手 - 如果服务跑在Docker里，
address=*:5005要确保容器端口已暴露且宿主机能访问，别只写了参数却忘了-p 5005:5005
IDEA配置Remote JVM Debug时，Host和Port必须和-agentlib中一致
IDEA里的Host填的是JVM所在机器的IP，不是localhost——哪怕你在本机跑服务，只要用了address=*:5005，IDEA里也得填127.0.0.1或localhost；但若JVM监听0.0.0.0:5005而你在另一台机器连，Host就得填那台机器的真实局域网IP。
容易踩的坑：
立即学习“Java免费学习笔记（深入）”；
- IDEA默认Host是
localhost，但JVM实际监听127.0.0.1（某些系统下二者不等价），导致连不上；统一用127.0.0.1最稳 - Port填错：比如JVM启在5005，IDEA却配成5006，错误信息通常是
Connection timed out - 勾选了
Allow unsigned requests？仅当用自签名SSL调试器时需要，普通JDWP不用管它
本地监听模式（Attach to Process）比远程调试更简单，但有JDK版本限制
如果你只是想调试本机正在运行的Java进程，不用改启动参数，直接用IDEA的Attach to Process功能就行——前提是JVM是同一台机器上、且JDK版本兼容。
使用场景：快速排查线上问题复现、调试第三方工具启动的Java服务（如Tomcat、Spring Boot DevTools）、不想动原有启动脚本。
- IDEA菜单栏：
Run → Attach to Process…，选中对应PID即可；注意右上角显示的JDK路径是否和目标进程一致 - JDK 8u212+ 和 JDK 11+ 默认禁用
Attach机制，会报错Unable to open socket file；需在目标JVM启动时加-Djdk.attach.allowAttachSelf=true，或改用tools.jar方式（不推荐） - Attach模式无法捕获JVM启动初期的代码（比如
static块、main入口前），这时只能退回去用-agentlib+suspend=y
调试配置保存后，别忽略Debug Configurations里的Use module classpath
IDEA调试时类路径来源有两个：一是目标JVM自己加载的jar（远程调试时完全依赖它），二是IDEA当前Module的编译输出（用于源码映射）。如果断点变灰、提示Classes not found，大概率是源码和远端字节码不匹配，或IDEA没认对class path。
关键点：
- 勾选
Use module classpath才能让IDEA用你当前项目的out/production或build/classes去匹配远端类；不勾选就只靠远端提供源码路径（基本不可靠） - 如果项目用了Lombok或MapStruct，确保
Annotation Processors已启用，否则生成的getter/setter方法里打不了断点 - 多模块Maven项目中，确认选中的Module是真正包含断点类的那个，不是父pom所在的module
Build → Build Project有没有成功，以及远端部署的jar是不是刚编译出来的。 
