Kubernetes集群内Socket.io客户端与服务端连接异常排查求助

核心问题现象 #

客户端（Angular+Socket.io）无法触发连接事件，但服务端（SpringBoot+Netty socket.io）能检测到连接；Postman通过WebSocket URL可正常连接，Angular默认使用Polling模式连接失败，强制WebSocket模式时服务端也无法检测到连接；已配置CORS允许所有源。

排查与解决思路 #

1. 修复Nginx Ingress的WebSocket转发配置 #

Nginx Ingress默认不会自动处理WebSocket的连接升级请求，需要添加专属注解开启支持：
在Ingress资源配置中加入以下内容：

annotations:
  # 指定需要支持WebSocket的后端服务名称
  nginx.ingress.kubernetes.io/websocket-services: "your-service-name"
  # 添加连接升级的Header配置
  nginx.ingress.kubernetes.io/configuration-snippet: |
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;

同时确认Ingress的路径规则正确，/socket.io/路径需直接转发到后端服务的对应端口。

2. 修正客户端连接代码的语法错误 #

原代码存在语法问题，transports参数未被正确包裹在配置对象中，且无需手动拼接/socket.io路径（客户端会自动处理）：

// 修正后的连接代码
this.socket = io("http://appteste.com", {
  transports: ['polling', 'websocket'],
  debug: true, // 开启调试日志便于排查
  withCredentials: true // 若服务端允许凭证传递则开启
});

3. 核对Socket.io版本兼容性 #

Netty-socket.io与官方Socket.io客户端存在版本绑定关系，不兼容会导致握手失败：

• 如果服务端使用com.corundumstudio.socketio:netty-socketio:1.7.x，客户端需对应使用socket.io-client:2.x版本
• 若服务端升级到netty-socketio:2.x，客户端可使用socket.io-client:4.x版本

4. 完善服务端CORS配置 #

确保Netty-socket.io的CORS配置覆盖必要参数，避免跨域相关的隐性错误：

Configuration config = new Configuration();
config.setHostname("0.0.0.0");
config.setPort(9092);
config.setOrigin("*"); // 生产环境建议替换为具体前端域名
config.setAllowCredentials(true); // 配合客户端withCredentials使用

5. 调试日志定位问题 #

• 客户端：开启debug: true后，在浏览器控制台查看Socket.io的连接日志，确认握手请求、升级请求的状态和响应内容
• 服务端：查看Netty-socket.io的日志，检查连接建立过程中是否有异常报错（如协议不匹配、路径错误）
• Nginx Ingress：查看Ingress的访问日志，确认请求是否被正确转发，有没有返回4xx/5xx错误码

内容的提问来源于stack exchange，提问作者João Lucas Mendes de Oliveira