当前位置: 代码网 > it编程>编程语言>Java > Java远程调试保姆级教程(附详细图文)

Java远程调试保姆级教程(附详细图文)

2025年07月16日 Java 我要评论
背景测试环境报错,但很难排查到问题,可以像本地debug的方式来调试远程代码准备1. xshell + 远程服务2. idea + 本地代码一、新增远程调试配置1. idea -> run -&

背景

测试环境报错,但很难排查到问题,可以像本地debug的方式来调试远程代码

准备

1. xshell + 远程服务

2. idea + 本地代码

一、新增远程调试配置

1. idea -> run -> edit configration 

2.确定一个未被占用远程和本地占用的端口,开始编辑配置, 我这边用的jdk8

复制出来的参数:

-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8205

二、服务添加远程调试参数

登录服务器模块,添加在第二步骤中复制的监听参数,然后重启服务,  手动启动jar,  或者编辑启动脚本,

手动启动参数如下:

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8205 -jar -xmx512m -xms512m web-4.2.jar

手动启动结果如下:

调整启动脚本示例如下:

手动启动会提示:listening for transport dt_socket at address: 8205

三、通过xshell将转发端口8205透传到本地

远程监听转发接口为8205,本地监听配置端口为8205,所以透传就是远程:8205 -> localhost:8205

四、开始远程调试

1.点击idea 的远程配置debug 按钮,启动远程调试web服务,成功启动页面如下:

2.对指定接口打上断点,  点击页面,触发接口,就会自动进入idea中断点位置

tips:

问题1:idea添加配置后启动debug按钮无法点击

排查远程服务是否启动失败, 排查监听端口是否透传成功

问题2:启动debug后等待一段时间弹出握手失败报错,然后停止监听

error running '82-12001' unable to open debugger port (localhost:8205): java.io.ioexception "handshake failed - connection prematurally closed"

去排查xshell透出的端口,是否跟远程转发端口一致。如上述步骤中所示:

web远程启动端口为12001,转发到8205端口, 此时我们需要将监听的8205端口传到本地localhost,  这样idea配置才能正常握手8025

问题3:调试断点无法进入

远程代码最好跟本地一致,以防出现断点无法进入情况

知识点:

idea添加远程配置时生成的jvm参数是用于配置java远程调试的核心参数,下面我详细解释每个部分的含义:

完整参数:

-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8205

分解解释:

  • -agentlib:jdwp

    • 表示加载jdwp(java debug wire protocol)代理库

    • 这是java调试的标准协议实现

  • transport=dt_socket

    • 指定调试器与被调试jvm之间的通信传输方式

    • dt_socket表示使用socket网络通信(最常用)

    • 替代选项:dt_shmem(共享内存,仅限本地调试)

  • server=y

    • 定义jvm作为调试服务端(等待调试器连接)

    • 如果设为n,则jvm会主动连接调试器(较少使用)

  • suspend=n

    • 控制jvm启动时是否暂停等待调试器连接

    • y:暂停,直到调试器连接(适合调试启动过程)

    • n:立即启动,调试器可以随时连接(生产环境推荐)

  • address=8205

    • 指定调试端口号(这里是8205)

    • jdk 9+需要格式:address=*:8205(允许任意ip连接)

    • 默认只接受本地连接,如需远程需明确指定ip

总结 

到此这篇关于java远程调试保姆级教程的文章就介绍到这了,更多相关java远程调试内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com