Linux环境下Java如何远程调试

Linux环境下Java远程调试实操指南

基于 JPDA/JDWP（Java Debug Wire Protocol），在目标 JVM 启动时加载调试代理，监听一个 Socket 端口，IDE 通过该端口“附加”到远程进程，实现断点、变量查看、单步执行等。适用于排查测试环境或预发环境的复杂问题。准备要点：
- 远程主机安装 JDK 5+，本地安装 IntelliJ IDEA/Eclipse。
- 规划并开放调试端口（如 5005），确保网络可达。
- 本地代码版本与远程部署版本尽量一致，避免断点错位。

服务端启动参数（推荐方式，适用于 Java 5+）
- 示例命令：
```
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar your-app.jar
```
- 关键参数说明：
  - transport=dt_socket：使用套接字传输。
  - server=y：当前 JVM 作为调试服务器，等待 IDE 连接。
  - suspend=n：启动不暂停；如需调试启动流程，可设为 y。
  - address=5005：监听端口（可自定义）。
本地 IDE 连接（以 IntelliJ IDEA 为例）
- 打开：Run → Edit Configurations → + → Remote JVM Debug。
- 配置：Host（远程服务器 IP）、Port（如 5005）。
- 点击 Debug 连接，连接成功后即可像本地一样设置断点与调试。

Spring Boot（可执行 JAR）
- 命令示例：
```
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar app.jar
```
- 如需调试应用启动早期逻辑，将 suspend 设为 y。
Apache Tomcat
- 方式一：使用 jpda 脚本
```
./catalina.sh jpda start
```
  默认 JPDA_ADDRESS=localhost:8000，远程无法访问；需改为 0.0.0.0:8000 或自定义端口。
- 方式二：在 catalina.sh 中设置环境变量
```
JPDA_TRANSPORT=dt_socket
JPDA_ADDRESS=0.0.0.0:5005
JPDA_SUSPEND=n
```
  或直接在 CATALINA_OPTS 中写入完整 JDWP 参数。
旧版兼容写法（不建议长期使用）
```
java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 -jar app.jar
```
现代 JDK 推荐使用 -agentlib:jdwp 形式。

开放服务器调试端口（示例为 5005/TCP）
- firewalld：
```
firewall-cmd --zone=public --add-port=5005/tcp --permanent
firewall-cmd --reload
```
- 云服务器：在安全组放行对应端口的入站规则。
避免仅绑定回环地址
- 若看到监听为 127.0.0.1:5005，外部无法连接；请将 address 设为 0.0.0.0:5005（或具体网卡 IP）。
内网穿透场景
- 无公网可达时，可用 cpolar 等内网穿透工具将本地 5005 暴露为公网可达的 TCP 地址，再在 IDE 中连接该公网地址。

连接被拒绝或超时
- 核对服务器监听地址与端口（非 127.0.0.1）、服务器防火墙/云安全组是否放行、端口是否被占用（如 netstat -an | grep 5005）。
断点不生效
- 本地源码与远程 class 版本不一致；或代码已热更新/重新部署导致行号偏移。重新构建并对齐版本。
性能与稳定性
- 远程调试会带来一定性能开销；生产环境慎用，调试完成及时移除调试参数并重启。
Docker/Kubernetes
- Docker：启动时映射端口 -p 5005:5005，并在命令中加入 JDWP 参数。
- Kubernetes：在 Deployment 的容器 ports 声明端口，并在 args 中配置 -agentlib:jdwp=...。