Docker容器中JRE 11远程调试遇IOException阻塞问题排查

根据你给出的ENTRYPOINT配置，我梳理几个最可能导致调试会话被IOException阻塞的核心原因：

1. 容器端口未映射到宿主机 #

这是最普遍的问题——你的容器内部监听了5005端口，但如果启动容器时没通过-p参数把容器端口映射到宿主机，宿主机上的调试客户端根本无法触达容器内部的调试端口。

正确的容器启动命令示例：

docker run -p 5005:5005 your-image-name

2. Java 9+版本的JDWP绑定限制 #

从Java 9开始，JDWP默认仅绑定localhost，这意味着调试端口只能被容器自身访问，宿主机或外部机器无法连接。你需要将address配置改为0.0.0.0:5005（或简写为*:5005），让它监听容器的所有网卡接口：

修改后的ENTRYPOINT：

ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom", "-Xdebug", "-agentlib:jdwp=transport=dt_socket,server=y,address=*:5005,suspend=n", "-jar","/backend.jar"]

3. 防火墙/安全组拦截请求 #

• 宿主机的防火墙可能拦截了5005端口的入站请求，需要检查并添加允许该端口访问的规则；
• 如果是云服务器部署，还要确认云服务商的安全组配置中，5005端口的入站规则处于开放状态。

4. 容器网络模式冲突 #

• 若使用--network host模式，调试端口会直接占用宿主机的5005端口，需确保该端口未被其他进程占用，同时防火墙开放此端口；
• 若用默认桥接模式，必须完成端口映射才能从外部访问容器内的调试端口。

5. 调试客户端连接地址错误 #

有时候问题出在客户端配置：

• 宿主机本地调试时，应连接localhost:5005（前提是已完成端口映射）；
• 外部机器调试时，需连接宿主机的公网/局域网IP+映射端口，比如192.168.1.100:5005；
• 不要直接使用容器内部IP，除非调试客户端和容器处于同一Docker网络。

建议先从端口映射和JDWP地址配置这两点入手排查，这两个是最容易踩的坑。

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