Java Debug如何调试远程服务

Java Debug调试远程服务的完整流程

一、远程服务端配置（关键前提）

要让远程Java服务支持调试，需通过JVM参数开启调试模式。不同场景的配置方式如下：

1. 普通Jar项目

在启动命令中添加-agentlib:jdwp参数（推荐，适用于Java 5+）：

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar your-service.jar

• 参数说明：
  • transport=dt_socket：使用Socket传输调试数据（跨机器首选）；
  • server=y：当前JVM作为调试服务器，等待客户端连接；
  • suspend=n：启动时不暂停（若设为y，程序会等待调试器连接后才开始执行，适合调试启动失败问题）；
  • address=5005：监听的调试端口（需唯一且未被占用）。

2. Tomcat Web项目

修改Tomcat启动脚本（bin/catalina.sh或catalina.bat），添加JVM参数：

# 在脚本开头或JAVA_OPTS定义处添加
export JAVA_OPTS="$JAVA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000"

或直接通过startup.sh的jpda模式启动（更便捷）：

./catalina.sh jpda start

默认会使用JPDA_ADDRESS=8000（可通过set JPDA_ADDRESS=9000修改端口）。

3. 容器化部署（Docker/K8s）

• Docker：启动容器时映射调试端口，并添加JVM参数：

  docker run -d -p 5005:5005 --name my-service -e JAVA_OPTS="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005" my-service-image
  

• K8s：在Deployment配置中添加端口映射和参数：

  spec:
    containers:
    - name: my-service
      ports:
      - containerPort: 5005  # 容器内调试端口
      args: ["-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005"]
  

4. 防火墙设置

确保远程服务器开放调试端口（以CentOS为例）：

# 开放端口（永久生效）
sudo firewall-cmd --zone=public --add-port=5005/tcp --permanent
# 重新加载防火墙规则
sudo firewall-cmd --reload

测试端口连通性（本地机器执行）：

telnet <远程服务器IP> 5005
# 若显示空白终端，说明连接成功

二、本地IDE配置（以IntelliJ IDEA/Eclipse为例）

1. IntelliJ IDEA

• 打开Run -> Edit Configurations，点击+选择Remote JVM Debug；
• 配置参数：
  • Name：自定义名称（如Remote-Debug-Prod）；
  • Transport：选择Socket（默认）；
  • Debugger mode：选择Attach（附加到远程服务器）；
  • Host：远程服务器IP或域名；
  • Port：与远程服务配置的address端口一致（如5005）；
• 点击Apply -> OK保存配置。

2. Eclipse

• 打开Run -> Debug Configurations，双击Remote Java Application创建新配置；
• 配置参数：
  • Name：自定义名称（如Remote-Debug-Tomcat）；
  • Project：选择本地对应的Java项目；
  • Connection Type：选择Standard (Socket Attach)；
  • Host：远程服务器IP或域名；
  • Port：与远程服务配置的address端口一致（如8000）；
• 点击Apply -> Debug启动调试会话。

三、开始远程调试

1. 启动调试会话：在IDE中启动配置好的Remote JVM Debug（如IntelliJ IDEA点击绿色虫子图标）；
2. 验证连接：控制台会输出Connected to the target VM, address: 'xxx.xxx.xxx.xxx:5005', transport: 'socket'，表示连接成功；
3. 设置断点：在本地代码中点击行号左侧设置断点（需确保本地代码与远程部署的代码版本完全一致，否则断点可能错位）；
4. 触发调试：通过HTTP客户端（如Postman）调用远程服务的对应接口，或执行相关业务逻辑；
5. 调试操作：当程序执行到断点时，IDE会暂停，可通过调试面板查看变量值、调用栈、执行表达式（如System.out.println()），或单步执行（F6/F5）。

四、注意事项

• 代码一致性：本地代码必须与远程部署的代码完全一致（包括依赖、配置），否则断点无法准确定位；
• 性能影响：远程调试会增加网络开销和JVM负载，生产环境严禁长期开启，调试完成后需移除调试参数并重启服务；
• 端口安全：调试端口需通过防火墙限制访问范围（如仅允许开发人员IP），避免未授权访问；
• 容器环境：Docker/K8s需确保端口映射正确，且容器内JVM参数配置无误；
• 启动模式：若远程服务启动慢或经常失败，可将suspend=y（启动时暂停），待调试器连接后再继续执行。