多AWS EC2实例下SocketIO连接失效问题排查求助

核心问题定位 #

单实例正常、扩缩容后仅WebSocket（/socket路由）无法连接，说明问题出在负载均衡器的长连接处理或多实例下的会话亲和性配置——HTTP接口（/api）是短连接，负载均衡器可正常分发，但WebSocket是长连接，需要保持会话绑定到同一实例。

1. 负载均衡器（AWS ALB/NLB）配置修正 #

会话亲和性（Session Stickiness）

WebSocket是长连接，客户端后续帧必须发送到同一实例，否则连接会直接中断：

• 打开AWS控制台的负载均衡器目标组配置，开启基于Cookie的会话亲和性，超时时间建议设为1天以上（匹配WebSocket长连接生命周期）。
• 确保针对/socket路径的转发规则继承会话亲和性配置。

协议与头转发配置

• 若使用AWS ALB：确认目标组协议为HTTP/1.1（WebSocket依赖HTTP/1.1的Upgrade机制），ALB默认会转发Upgrade和Connection头，无需额外配置，但要检查是否有自定义规则覆盖了这些头。
• 若使用AWS NLB：需配置TCP监听（而非HTTP），NLB不处理HTTP头，直接转发TCP流量，此时Nginx的WebSocket配置仍需保留。

目标组健康检查

确认扩缩容后的新实例已加入目标组，且健康检查状态为健康（建议用/api路径作为健康检查端点，确保NodeJS服务正常运行）。

2. Nginx配置优化 #

现有/socket配置基本正确，需补充长连接超时设置并完善代理头：

location /socket {
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        # 用双引号避免Nginx解析错误
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
        proxy_pass http://localhost:3000;
        
        # 禁用缓存，避免长连接被缓存中断
        proxy_cache off;
        # 设置超长超时，匹配WebSocket长连接需求
        proxy_connect_timeout 7d;
        proxy_send_timeout 7d;
        proxy_read_timeout 7d;
}

修改后重启Nginx生效：sudo systemctl restart nginx

3. NodeJS Socket服务器配置验证 #

如果使用Socket.io等库，需确保：

• 服务器监听路径与Nginx的/socket路由匹配（例如Socket.io默认路径是/socket.io，需调整为/socket，或修改Nginx的location为/socket.io）。
• 开启代理信任，识别来自Nginx的请求：

const io = require('socket.io')(server, {
  cors: {
    origin: "你的Angular域名", // 避免跨域问题
    methods: ["GET", "POST"]
  },
  // 信任Nginx代理，获取真实客户端IP
  proxy: true,
  // 匹配Nginx转发的路径
  path: "/socket"
});

4. 安全组与网络ACL排查 #

• 自动扩缩容的EC2启动模板中，安全组需允许负载均衡器的安全组访问3000端口。
• 负载均衡器的安全组需允许客户端访问80/443端口（WebSocket流量通过这些端口进入）。
• 网络ACL需放行入站的80/443端口，以及出站的3000端口（Nginx到NodeJS的流量）。

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