AKS部署Socket.IO时握手auth缺失且连接频繁断开问题

核心问题定位 #

本地正常、AKS环境异常的核心原因是Ingress路径重写规则与服务端Socket.IO路径配置不匹配，导致握手请求无法被服务端正确解析，同时Websocket连接的超时和Header配置不规范引发频繁断连。

具体修复步骤 #

1. 修正Ingress路径映射，匹配服务端Socket.IO配置 #

服务端Socket.IO设置了path: "/nodeserver/socket.io/"，意味着服务端仅监听该路径的请求。但当前Ingress的重写规则会将/nodeserver/socket.io/截断为/socket.io/，导致服务端无法识别握手请求，Auth数据自然丢失。

修改Ingress的paths和rewrite-target配置：

ingress:
  enabled: true
  className: "nginx"
  annotations: 
    nginx.ingress.kubernetes.io/use-regex: "true"
    # 调整重写规则，完整保留/nodeserver前缀
    nginx.ingress.kubernetes.io/rewrite-target: /nodeserver$1
    appgw.ingress.kubernetes.io/backend-protocol: "http" 
    appgw.ingress.kubernetes.io/request-timeout: "3600" # 延长超时时间适配长连接
    nginx.ingress.kubernetes.io/proxy-set-header: "Upgrade $http_upgrade"
    # 使用变量而非硬编码，适配不同请求场景
    nginx.ingress.kubernetes.io/proxy-set-header: "Connection $connection_upgrade"
  hosts:
    - host: my-server-app.cloudapp.azure.com
      paths:
        - path: /nodeserver(.*)
          pathType: ImplementationSpecific

2. 完善Websocket连接稳定性配置 #

为避免连接被Ingress或网关主动断开，补充以下关键配置：

• 添加websocket-services注解指定后端服务，确保Nginx正确路由Websocket流量：

  nginx.ingress.kubernetes.io/websocket-services: "your-backend-service-name"
  

• 延长代理超时时间，适配长连接场景：

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

3. 统一Socket.IO客户端与服务端版本 #

客户端4.8.1与服务端4.7.5存在小版本差异，可能引发兼容性问题。将客户端版本调整为^4.7.5，保持两端版本一致。

4. 验证服务端请求接收 #

在服务端代码中添加请求路径打印，确认接收到的路径与配置一致：

var io = require('socket.io')(app.listen(port), { path: "/nodeserver/socket.io/" });
// 添加请求路径日志，排查路由是否正确
app.use((req, res, next) => {
  console.log("Received request path:", req.path);
  next();
});
io.sockets.on('connection', function (socket) {
  console.log("Handshake data:", socket.handshake);
  console.log(JSON.stringify(socket.handshake.auth));
});

5. 排查AKS网络限制 #

• 确认AKS网络策略未阻止80/443端口的TCP流量，以及带有Upgrade: websocket头的请求。
• 若使用Azure应用网关，检查网关是否启用Websocket支持，且超时设置与Ingress保持一致。

验证方案 #

部署修改后的配置后：

1. 观察服务端日志，确认socket.handshake.auth能正常打印用户ID和Token。
2. 监控客户端连接状态，确认无频繁断开、重连现象。

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