Node.js Socket.io连接Flutter应用失败，疑版本兼容问题求助

核心原因：版本兼容性不匹配 #

Socket.io服务端与客户端存在严格的版本兼容对应规则，你当前使用的Node.js服务端（4.5.1）属于4.x系列，而Flutter端的socket.io-client（2.0.0）是2.x系列，两者协议不兼容，这是连接失败的直接原因。

解决方案：升级Flutter客户端版本 #

Flutter的socket.io-client已有适配4.x服务端的稳定版本，你需要将依赖升级到4.x系列（当前最新稳定版为4.0.2）。

步骤1：更新项目依赖 #

在Flutter项目的pubspec.yaml中修改依赖：

dependencies:
  socket_io_client: ^4.0.2

执行flutter pub get完成依赖更新。

步骤2：调整连接代码 #

升级后需适配4.x版本的API，示例代码如下：

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

void initSocketConnection() {
  IO.Socket socket = IO.io('http://你的服务端地址:端口', <String, dynamic>{
    'transports': ['websocket'], // 强制使用websocket传输，规避部分环境下的轮询异常
    'autoConnect': false,
  });

  socket.connect();

  socket.onConnect((_) {
    print('连接成功');
    socket.emit('message', '来自Flutter客户端的测试消息');
  });

  socket.onConnectError((error) {
    print('连接错误: $error');
  });

  socket.onDisconnect((_) {
    print('连接断开');
  });
}

额外排查点 #

若升级后仍无法连接，检查以下内容：

• 服务端CORS配置：Node.js服务端需允许Flutter客户端的访问来源，示例配置：

  const io = require('socket.io')(server, {
    cors: {
      origin: "http://你的Flutter客户端IP:端口", // 测试阶段可临时用"*"，生产环境需指定具体地址
      methods: ["GET", "POST"]
    }
  });
  

• 自定义路径匹配：若服务端设置了Socket.io自定义路径（如path: '/socket.io'），Flutter客户端需同步指定：

  IO.Socket socket = IO.io('http://你的服务端地址:端口', <String, dynamic>{
    'transports': ['websocket'],
    'path': '/socket.io', // 与服务端路径保持一致
  });
  

• 网络连通性：确保Flutter客户端与Node.js服务端处于同一网络，或服务端可被公网访问。

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