调试Java应用遇端口握手失败及连接拒绝问题求解决

排查端口占用 #

• 先确认目标端口是否被其他进程占用：
  • Windows：运行 netstat -ano | findstr :8000 找到占用端口的PID，打开任务管理器结束对应进程
  • Linux/macOS：运行 lsof -i :8000 或 ss -tulpn | grep :8000，用 kill -9 <PID> 终止占用进程

匹配调试器与应用配置 #

• 确认调试模式：应用启动参数里是server=y（应用作为调试服务端），所以调试器要设为客户端模式连接，别搞反了
• 检查主机与防火墙：本地调试时，确认防火墙没拦截端口；如果调试器和应用不在同一机器，把localhost换成应用所在机器的IP

绕开命令行参数限制的方法 #

• 从IDE调试配置改：如果是IDE自动生成的启动参数，直接去对应应用的Run/Debug Configuration里找VM Options或Debugger设置，修改address的端口值，IDE会自动同步启动参数
• 清理IDE缓存：如果配置被锁定，试试清理IDE缓存再重建配置：
  • IntelliJ IDEA：File -> Invalidate Caches...，重启IDE
  • Eclipse：删除.metadata目录下的调试配置文件，或者File -> Refresh后重新创建调试配置
• 检查应用配置文件：部分框架（比如Spring Boot）会在application.properties/application.yml里配置调试参数，找到对应项修改端口即可

其他排查点 #

• 对齐JDK版本：调试器的JDK版本要和应用运行的JDK版本一致，版本不匹配可能导致握手失败
• 关闭本地代理：代理软件可能拦截调试端口连接，临时关闭后再测试

内容的提问来源于stack exchange，提问作者user18434972