Docker容器中Tomcat应用远程调试连接重置问题求助

问题分析 #

你遇到的连接重置问题，核心原因大概率是Java 21（及17+版本）默认将远程调试端口绑定到容器内部的回环地址（127.0.0.1），即使Docker做了端口映射，宿主机器也无法访问容器内的回环端口。以下是具体的排查和解决步骤：

解决方案 #

1. 修改JPDA_ADDRESS为0.0.0.0:8000 #

Java 17+对远程调试的默认绑定地址做了限制，仅设8000会自动绑定到127.0.0.1，必须明确指定绑定到所有网卡：

• 修改Dockerfile：

  FROM tomcat
  
  COPY target/demo-1.0-SNAPSHOT.war /usr/local/tomcat/webapps/ROOT.war
  
  ENV JPDA_ADDRESS="0.0.0.0:8000"
  ENV JPDA_TRANSPORT="dt_socket"
  
  CMD ["catalina.sh", "jpda", "run"]
  

• 或在启动脚本中覆盖：

  #!/bin/bash
  
  docker run -e JPDA_ADDRESS=0.0.0.0:8000 \
             -p 8080:8080 \
             -p 8000:8000 \
             --name demo \
             pol/demo:latest \
             catalina.sh jpda run
  

2. 验证容器内端口监听状态 #

进入容器确认调试端口是否绑定到所有网卡：

# 进入容器
docker exec -it demo bash
# 安装netstat（若容器未预装）
apt update && apt install -y net-tools
# 检查端口
netstat -tulpn | grep 8000

正确输出应包含0.0.0.0:8000，而非127.0.0.1:8000。

3. 直接指定JVM调试参数（备选方案） #

若修改JPDA环境变量无效，可跳过Tomcat的jpda脚本，直接传递完整的JVM调试参数：

docker run -p 8080:8080 \
           -p 8000:8000 \
           --name demo \
           pol/demo:latest \
           catalina.sh run \
           -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000

address=*:8000是Java 17+推荐的写法，明确允许所有地址访问调试端口。

4. 检查IntelliJ配置 #

确保IntelliJ远程调试配置符合以下要求：

• 模式：Attach to remote JVM
• 主机：本地Docker填localhost，远程服务器填对应IP
• 端口：8000
• 传输：Socket
• 调试器模式：Attach
• 确保IntelliJ使用的Java版本与容器内的OpenJDK 21一致

5. 排除网络拦截 #

• 检查宿主机器防火墙是否允许8000端口入站
• 远程服务器需确认云服务商安全组已开放8000端口

验证 #

重启容器后，用telnet测试端口连通性：

telnet localhost 8000

若连接保持不中断，说明端口已正常开放，此时启动IntelliJ远程调试即可成功连接。

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