部署在Kubernetes上的Docker容器内Socket无法连接问题排查求助

1. Nginx Ingress未开启WebSocket支持 #

Socket.io依赖HTTP协议升级为WebSocket的机制，默认Nginx Ingress没有配置相关升级头，会直接拦截升级请求导致报错。
修复：在Ingress的annotations里添加以下配置：

nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"
nginx.ingress.kubernetes.io/upgrade: "websocket"
nginx.ingress.kubernetes.io/connection: "upgrade"

2. Socket.io路径不匹配 #

Socket.io客户端默认会在你传入的ENDPOINT后拼接/socket.io路径发起请求，你当前配置的ENDPOINT是https://traveling.dev/api/chat，实际请求地址会变成https://traveling.dev/api/chat/socket.io，Ingress规则虽然匹配了/api/chat/?(.*)能把请求转发到chat服务，但服务端Socket.io默认监听根路径下的/socket.io，收不到请求。
修复：两端统一路径配置，比如在客户端初始化时指定path：

const chatSocket = io(ENDPOINT, {
  rejectUnauthorized: false,
  forceNew: true,
  secure: true, // 你用的是HTTPS endpoint，这里要改为true
  path: "/api/chat/socket.io" // 显式指定路径
});

也可以选择在服务端初始化Socket.io时指定path：

const io = new Server(server, {
  cors: {
    origin: "*",
    methods: ["*"],
    allowedHeaders: ["*"],
  },
  path: "/api/chat/socket.io"
});

3. 客户端secure参数配置错误 #

你的ENDPOINT是HTTPS协议，但你把secure设为了false，会导致SSL握手阶段异常，直接修改为true即可。

4. 缺少会话保持配置（后续扩缩容副本必须配置） #

当Deployment副本数大于1时，Socket.io的连接请求可能被转发到不同的Pod，导致握手失败。提前配置会话保持可以避免该问题，在Ingress annotations添加：

nginx.ingress.kubernetes.io/affinity: "cookie"
nginx.ingress.kubernetes.io/affinity-mode: "persistent"
nginx.ingress.kubernetes.io/session-cookie-name: "socket_io_sid"

同时建议在Deployment的容器配置里添加containerPort: 3000，明确声明端口避免后续配置错误。

• 首先在浏览器开发者工具的网络tab里查看Socket.io的请求状态，不同状态对应不同问题：
  • 404：路径匹配错误，检查Ingress规则和Socket.io的path配置
  • 502/503：检查Pod是否正常运行，Service是否正确关联Pod，有没有端口配置错误
• 进入Pod查看服务端日志，看请求有没有打到Pod里，如果没有日志说明Ingress/Service转发失败，如果有报错日志可以根据报错信息调整服务端配置
• 先绕过Ingress，用kubectl port-forward把本地端口直接映射到Pod的3000端口，本地测试连接是否正常，如果正常说明问题出在Ingress层，如果还是有问题说明是容器内服务配置错误
• 开启Socket.io的debug日志，客户端添加环境变量DEBUG=socket.io*，服务端同样开启debug日志，可以拿到更详细的握手阶段错误信息

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