Flutter与Node.js中Socket.io连接失败问题排查求助

看起来你遇到了Flutter客户端无法连接Node.js Socket.io服务的问题，我帮你梳理几个关键的排查点和解决方案：

1. 优先确认版本兼容性 #

Socket.io的服务端和客户端版本必须严格匹配，这是最容易踩的坑：

• 先查看Node.js项目package.json中的socket.io版本：
  • 如果是v4.x，Flutter的socket_io_client需要用^2.0.0及以上版本；
  • 如果是v3.x，客户端对应^1.0.0版本；
  • 版本不匹配会直接导致连接失败，且可能没有明确报错提示。

2. 修复客户端Socket初始化逻辑 #

你的客户端代码有两个关键问题：没有手动调用connect()，也没有指定传输方式（Android环境下默认配置可能失效）。修改initState代码如下：

@override
void initState() {
  super.initState();
  
  // 配置连接参数
  final socket = client.io(
    'http://192.168.42.51:3000',
    client.OptionBuilder()
        .setTransports(['websocket', 'polling']) // 显式指定传输方式，兼容Android环境
        .disableAutoConnect() // 关闭自动连接，手动控制连接时机
        .build(),
  );

  // 监听关键事件，方便排查问题
  socket.onConnect((_) {
    print('✅ 成功连接到Socket.io服务');
    socket.emit("connectedUser", {
      "userId": socket.id,
      "userName": "Woo Bear",
    });
  });

  socket.onConnectError((error) {
    print('❌ 连接失败：$error'); // 打印错误信息，快速定位问题根源
  });

  socket.onDisconnect((_) => print('🔌 已断开连接'));

  socket.on("connectedUsers", (data) => print('在线用户：$data'));

  // 手动触发连接
  socket.connect();
}

3. 服务端配置CORS权限 #

即使是局域网环境，Socket.io服务端也需要配置CORS允许客户端请求。修改服务端的Socket.io初始化代码：

// 替换原来的io初始化代码
const io = require('socket.io')(httpServer, {
  cors: {
    origin: "*", // 测试阶段允许所有来源，正式环境建议指定客户端域名/IP
    methods: ["GET", "POST"]
  }
});

4. 确认网络与设备权限 #

• 检查Android设备和Node.js服务器是否在同一局域网：可以用设备浏览器访问http://192.168.42.51:3000，如果能看到Socket.io的默认欢迎页面，说明网络连通没问题；
• 确保Android应用拥有网络权限：在android/app/src/main/AndroidManifest.xml中添加：

  <uses-permission android:name="android.permission.INTERNET" />
  

额外提示：服务端业务逻辑优化 #

你的服务端代码中，connectedUsers数组在用户连接时添加，但没有处理重复的socket.id，另外connectedUser事件接收数据后没有更新数组，这会导致在线用户统计不准确，但不影响连接功能，后续可以优化：

socket.on("connectedUser", (data) => {
  console.log(data);
  const { userId, userName } = data;
  // 添加用户到在线列表，避免重复
  const existingUser = connectedUsers.find(user => user.socketId === socket.id);
  if (!existingUser) {
    connectedUsers.push({ socketId: socket.id, userId, userName });
  }
});

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