如何使用go-socket.io-client实现Socket.IO客户端认证？

问题场景 #

Node.js客户端通过io()的auth配置传递认证信息建立Socket.IO连接：

const socket = io({
    auth: {
        userId: "",
        username:"",
    }
});

使用Golang的go-socket.io-client时，原代码通过URL Query传递参数：

opts := &socketio_client.Options{
    Transport: "websocket",
    Query:     make(map[string]string),
}
opts.Query["user"] = "user"
opts.Query["pwd"] = "pass"
uri := "http://192.168.1.70:9090/socket.io/"

client, err := socketio_client.NewClient(uri, opts)
if err != nil {
    log.Printf("NewClient error:%v\n", err)
    return
}

尝试将Auth结构体序列化后存入Query["auth"]时触发io.EOF错误，原因是Query属于Socket.IO底层URL查询参数，并非Socket层的标准auth参数。

正确实现方式 #

Socket.IO的auth参数是在握手阶段作为握手payload的一部分发送，而非URL Query。针对go-socket.io-client，推荐使用以下方式：

1. 使用Options.Auth字段（推荐，适配v1.4+版本）

新版本的go-socket.io-client提供了Auth字段，可直接对应Node.js的auth选项：

import (
    "log"
    socketio_client "github.com/googollee/go-socket.io-client"
)

func main() {
    opts := &socketio_client.Options{
        Transport: "websocket",
        Auth: map[string]interface{}{
            "userId":   "", // 填入实际用户ID
            "username": "", // 填入实际用户名
        },
    }
    uri := "http://192.168.1.70:9090/socket.io/"

    client, err := socketio_client.NewClient(uri, opts)
    if err != nil {
        log.Printf("NewClient error:%v\n", err)
        return
    }

    // 后续处理连接事件、消息收发等逻辑
}

2. 兼容旧版本的替代方案

如果使用的库版本不支持Auth字段，可通过ExtraHeaders传递认证信息（需服务端配合解析），但更建议升级到支持标准Auth字段的库版本，以符合Socket.IO官方认证规范。

注意：不要将敏感认证数据放入Query中，这不仅会导致数据暴露，还会破坏Socket.IO的握手流程，引发连接错误。

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