Java调试通过-agentlib:jdwp参数启用，核心格式为-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005，支持命令行、Maven、IDE及Docker等多种配置方式，需注意端口、网络与安全限制。
在Java环境中开启调试参数，核心是通过JVM启动选项添加-agentlib:jdwp参数，使JVM进入调试就绪状态，从而允许IDE（如IntelliJ IDEA、Eclipse）或调试工具远程连接。
调试参数基本格式与关键选项
标准调试启动参数如下：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
各部分含义说明：
立即学习“Java免费学习笔记（深入）”；
- transport=dt_socket：指定使用Socket通信（最常用）
- server=y：表示当前JVM作为调试服务端，等待IDE连接
-
suspend=n：启动时不挂起主线程；设为
y则JVM会暂停直到调试器接入（适合调试启动逻辑） -
address=*:5005：监听所有网卡的5005端口（Java 8及更早用
address=5005；Java 9+支持*:5005以允许远程连接）
不同运行场景下的配置方式
根据应用部署方式选择对应配置入口：
-
命令行启动（如jar包）：
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar app.jar -
Maven插件（spring-boot:run）：
在pom.xml中配置spring-boot-maven-plugin的jvmArguments，或直接运行：mvn spring-boot:run -Dspring-boot.run.jvmArguments="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005" -
IDE内启动（推荐开发时用）：
IntelliJ IDEA：右键类→Debug 'ClassName.main()'，IDE自动添加调试参数；也可在Run → Edit Configurations → Modify options → Enable debug agent手动配置端口 -
Docker容器中启用调试：
在docker run命令中加入-e JAVA_TOOL_OPTIONS="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"，并映射端口：-p 5005:5005
常见问题与安全提醒
调试模式开启后需注意以下几点：
-
端口冲突：确保5005（或其他自定义端口）未被占用，可通过
netstat -an | grep 5005（Linux/macOS）或netstat -ano | findstr :5005（Windows）检查 -
防火墙/网络限制：远程调试时，宿主机或云服务器需开放对应端口，且
address=*:5005需JDK 9+支持；旧版本请改用address=0.0.0.0:5005并确认JVM兼容性 -
生产环境禁用：调试参数会暴露JVM内部状态，切勿在生产环境启用，尤其避免使用
suspend=y导致服务无法启动 -
IDE连接失败排查：确认IDE调试配置中的host/port与JVM一致；检查是否启用了SSL（默认不启用，无需额外配置）；查看JVM启动日志是否输出
Listening for transport dt_socket at address: 5005
调试参数本身不改变业务逻辑，只打开JDWP协议通道。配对正确后，IDE即可设置断点、查看变量、单步执行——关键在于JVM与调试器两端的transport、address、port严格一致。
