配置AWS ALB后Flutter移动端无法连接Socket.IO的排查与解决

核心排查方向与修复步骤 #

1. 修正ALB监听器与目标组的协议匹配 #

ALB的HTTPS监听器负责终止SSL时，目标组的协议必须和EC2上的Socket.IO服务协议一致：

• 如果你的EC2服务未配置SSL证书（所有加密在ALB侧完成），目标组必须使用HTTP协议转发到EC2的1605端口，而非HTTPS——否则ALB会向EC2发送HTTPS请求，而EC2服务只监听HTTP，导致握手失败。
• 如果EC2服务自身配置了SSL证书，目标组才用HTTPS协议，同时要确保ALB的SSL证书和EC2的证书都覆盖example.com域名。

2. 调整目标组健康检查配置 #

ALB只会向健康的实例转发流量，必须配置适配Socket.IO的健康检查规则：

• 健康检查路径设为Socket.IO可响应的端点：/socket.io/?EIO=4&transport=polling，这个路径是Socket.IO v4.x默认支持的轮询路径。
• 确保健康检查的协议、端口与EC2服务完全匹配，比如EC2用HTTPS 1605，健康检查就选HTTPS协议、1605端口。

3. 修正Socket.IO服务端与客户端的代理兼容配置 #

服务端（TypeScript + socket.io v4.7.5）

必须添加代理信任配置，让Socket.IO识别ALB转发的请求：

import { createServer } from 'https';
import express from 'express';
import { Server } from 'socket.io';
import fs from 'fs';

const app = express();
// 若ALB终止SSL，这里可改用HTTP服务器（createServer不带证书参数）
const server = createServer({
  key: fs.readFileSync('server.key'),
  cert: fs.readFileSync('server.cert')
}, app);

const io = new Server(server, {
  cors: {
    origin: "https://example.com", // 允许你的域名及Flutter客户端来源
    methods: ["GET", "POST"]
  },
  proxy: true, // 关键：信任反向代理（ALB）
  transports: ["polling", "websocket"], // 明确支持ALB兼容的传输方式
  serveClient: false
});

Flutter客户端（socket_io_client v2.0.3+1）

补充适配ALB的参数：

import 'package:socket_io_client/socket_io_client.dart' as IO;

IO.Socket socket = IO.io('https://example.com:1605', <String, dynamic>{
  'transports': ['polling', 'websocket'], // 与服务端传输方式一致
  'autoConnect': false,
  'extraHeaders': {'Origin': 'https://example.com'}, // 匹配服务端CORS规则
});
socket.connect();

4. 检查安全组与网络ACL规则 #

• EC2安全组：将入站1605端口的规则从0.0.0.0/0改为允许ALB安全组的访问——现在流量来自ALB，而非直接的客户端IP，开放给所有人会有安全风险，也可能因为ALB的源IP不在允许范围内导致连接失败。
• ALB安全组：确保入站规则允许客户端IP范围访问1605端口（TCP协议）。
• VPC网络ACL：入站、出站规则都要允许1605端口的TCP流量，覆盖客户端→ALB、ALB→EC2的方向。

5. 利用日志定位问题 #

• 开启ALB访问日志（存储到S3），查看1605端口请求的状态码：
  • 502 Bad Gateway：ALB无法连接到EC2，排查目标组健康状态、EC2服务是否正常运行、协议是否匹配。
  • 403 Forbidden：CORS配置错误或SSL证书不匹配。
  • 404 Not Found：健康检查路径错误或Socket.IO服务路径配置异常。
• 查看EC2上的Socket.IO服务日志，确认是否收到ALB转发的请求，若没有则排查网络链路；若有错误日志，根据报错信息（如SSL握手失败）调整协议配置。

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