Docker容器内Python Socket连接异常，请求排查故障原因

问题根源 #

你的服务端Socket代码绑定了localhost，这会导致服务仅监听容器内部的回环接口，宿主机的请求无法通过端口映射到达服务端。

修改后的服务端代码 #

将绑定地址从localhost改为0.0.0.0，让服务监听容器的所有网络接口：

import socket

print("Starting...")
with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
    s.bind(('0.0.0.0', 2222))  # 关键修改：替换localhost为0.0.0.0
    print("Bound...")

    while True:
        print("Listening...")

        s.listen()

        conn, addr = s.accept()
        with conn:
            print('Connected by', addr)

            recData = ""
            while True:
                data = conn.recv(1024)
                if not data:
                    break
                print(f"Received: {data}")
                recData += data.decode("utf-8")
                conn.sendall(data)
            
            print(f"Received all: {recData}")

原因说明 #

• 在Docker容器内，localhost指向容器自身的回环地址（127.0.0.1），仅能接收容器内部的请求。
• 绑定0.0.0.0表示监听容器的所有可用网络接口，这样宿主机通过端口映射-p 2222:2222/tcp发送的请求才能被服务端接收。

验证步骤 #

1. 修改服务端代码后，重新构建镜像：

docker build -t test .

2. 重新运行容器：

docker run -d -p 2222:2222/tcp --name Test test

3. 在本地运行客户端脚本，此时客户端应该能收到服务端返回的Hello, world，服务端日志也会显示连接信息和接收的数据。

补充说明 #

你的Dockerfile和端口映射配置是正确的，问题仅出在服务端的绑定地址上。

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