Python SocketIO应用Docker部署后WebSocket连接被拒绝问题排查

• 确认SocketIO服务器启动参数是否正确绑定0.0.0.0
  部分SocketIO框架（如Flask-SocketIO）需要在启动时显式指定host='0.0.0.0'，仅设置端口无法确保容器内服务器对外监听。检查你的my_server.py，确保启动代码类似以下示例：

  # Flask-SocketIO启动示例
  from flask import Flask
  from flask_socketio import SocketIO
  
  app = Flask(__name__)
  socketio = SocketIO(app)
  
  if __name__ == '__main__':
      socketio.run(app, host='0.0.0.0', port=8080)
  

  避免服务器仅监听容器内的127.0.0.1，导致外部无法访问。

• 验证Docker端口映射是否实际生效
  在主机终端执行命令检查8080端口是否被Docker进程监听：

  • Windows：netstat -ano | findstr :8080
  • Linux/macOS：lsof -i :8080 或 netstat -anp | grep 8080
    如果未发现Docker相关进程监听该端口，说明端口映射配置失效，可尝试重启docker-compose，或检查docker-compose.yml中ports格式是否为主机端口:容器端口。

• 排查SocketIO依赖版本与传输协议兼容性
  本地与Docker环境的依赖版本差异可能导致协议不兼容：

  1. 对比版本：在容器内执行pip list | grep socketio，与本地pip list | grep socketio输出对比，确保python-socketio、python-engineio版本一致。
  2. 客户端显式指定传输方式：同时启用WebSocket和长轮询，避免单一传输方式失败：

     import socketio
     
     sio = socketio.Client(transport=['websocket', 'polling'])
     try:
         sio.connect('http://localhost:8080')
     except Exception as e:
         print(e)
     

• 测试容器内部的服务器可达性
  进入容器内部验证服务器是否正常运行：

  1. 执行docker exec -it <容器ID> bash进入容器
  2. 安装测试工具：pip install requests 或 npm install -g wscat
  3. 测试HTTP接口：curl http://localhost:8080，检查是否有响应
  4. 测试WebSocket连接：wscat -c ws://localhost:8080/socket.io/?EIO=4&transport=websocket，若能连接则说明容器内服务器正常，问题出在外部网络或防火墙。

• 检查主机防火墙与Docker Desktop网络配置

  • 临时关闭系统防火墙测试，确认是否是防火墙阻止了8080端口的入站连接。
  • Docker Desktop端：进入设置>网络，确认网络模式配置正常，可尝试切换到"Legacy"网络模式（Windows）。

• 确认SocketIO命名空间配置
  若服务器使用了自定义命名空间，客户端必须指定对应命名空间才能连接：

  # 服务器端自定义命名空间示例
  @socketio.on('connect', namespace='/custom')
  def handle_connect():
      print('Client connected to /custom')
  
  # 客户端需指定命名空间
  sio.connect('http://localhost:8080', namespaces=['/custom'])
  

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