Go Socket.IO与React客户端连接时出现命名空间断开错误求助

核心问题：协议版本不兼容 #

go-socket.io 1.7 实现的是Socket.IO 协议v2，而 socket.io-client 4.7.5 使用的是Socket.IO 协议v4，两者协议版本不兼容，这是连接失败的主要原因。

解决思路二选一： #

• 方案一：升级服务端go-socket.io版本（推荐）
  安装支持v4协议的新版本：

  go get github.com/googollee/go-socket.io/v4@latest
  

  修改服务端代码的导入和初始化逻辑：

  // 替换导入路径为v4版本
  socketio "github.com/googollee/go-socket.io/v4"
  
  // 初始化server时配置socket.io专属CORS
  server := socketio.NewServer(&socketio.ServerConfig{
      Cors: &socketio.CorsConfig{
          AllowOriginFunc: func(origin string) bool {
              return true // 调试用，生产环境请限制具体域名
          },
          AllowCredentials: true,
      },
  })
  

• 方案二：降级客户端socket.io-client版本
  安装与服务端协议匹配的v2版本：

  npm install socket.io-client@2.5.0
  

  客户端现有连接逻辑无需大幅修改。

服务端其他潜在问题修复 #

1. 补充OPTIONS请求支持
   原Gin的CORS配置仅允许GET、POST，socket.io握手阶段会发送OPTIONS预检请求，需添加到允许方法列表：

   app.Use(cors.New(cors.Config{
       AllowOrigins:     []string{"*"},
       AllowMethods:     []string{"GET", "POST", "OPTIONS"}, // 新增OPTIONS
       AllowHeaders:     []string{"Origin", "Content-Length", "Content-Type", "Authorization"},
       ExposeHeaders:    []string{"Content-Length"},
       AllowCredentials: true,
       MaxAge:           12 * time.Hour,
   }))
   

2. 修正socket.io路由挂载方式
   原gin.WrapH(server)可能无法完整处理所有socket.io请求，改用自定义handler转发：

   // 替换原有的GET/POST路由
   app.Any("/socket.io/*any", func(c *gin.Context) {
       server.ServeHTTP(c.Writer, c.Request)
   })
   

客户端代码优化 #

1. 添加连接状态监听
   便于排查连接失败的具体原因，在useEffect中补充：

   newSocketConnection.on("connect_error", (error) => {
       console.error("连接错误:", error);
   });
   
   newSocketConnection.on("connect", () => {
       console.log("连接成功，Socket ID:", newSocketConnection.id);
   });
   

2. 修正清理函数类型
   原返回函数类型错误，调整为：

   return () => {
       newSocketConnection.close();
   };
   

验证步骤 #

1. 按上述方案修改服务端或客户端版本
2. 重启服务端和客户端
3. 查看浏览器控制台是否输出"连接成功"日志，服务端控制台是否打印connected: [ID]

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