Go连接SignalR服务器遇问题：WebSocket升级后握手失败求助

你已经完成了令牌获取和协商步骤，WebSocket也成功升级，现在卡在握手阶段，大概率是请求细节、认证传递或者数据格式的问题，以下是几个具体的排查方向：

1. 检查请求头是否完整 #

很多SignalR服务器会校验请求头，比如模拟浏览器请求的User-Agent，或者X-Requested-With头。你当前拨号时没有设置任何头，试试添加这些：

headers := http.Header{}
headers.Add("X-Requested-With", "XMLHttpRequest")
headers.Add("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36")
ws, resp, err := websocket.DefaultDialer.Dial(u.String(), headers)

2. 确保connectionData已URL编码 #

你当前的connectionData是明文放在URL参数里的，这会导致JSON中的特殊字符（比如[、{、"）被服务器解析错误。必须对其进行URL编码：

import "net/url"

connectionData := `[{"name":"HubName"}]`
encodedConnData := url.QueryEscape(connectionData)
// 然后拼到URL的RawQuery中：&connectionData=` + encodedConnData

3. 尝试更换令牌的传递方式 #

有些SignalR服务端不支持在URL中传递access_token，更标准的做法是放在Authorization请求头里：

headers.Add("Authorization", "Bearer "+你的令牌字符串)

同时记得从URL中移除&access_token=${MyRetrievedToken}参数。

4. 调试握手后的响应 #

你当前发送握手消息后没有尝试读取服务器的响应，添加读取逻辑看看服务器是否返回了错误信息：

// 发送握手消息后立即读取响应
_, msg, err := ws.ReadMessage()
if err != nil {
    return nil, err
}
fmt.Println("握手响应：", string(msg))

如果服务器返回错误，比如协议不支持、令牌无效，这里会直接拿到提示。

5. 对比标准客户端的请求细节 #

用浏览器开发者工具（Network面板）抓一个正常的SignalR连接请求，对比以下内容：

• WebSocket连接的请求头是否和你代码中的一致
• connectionData参数是否经过编码
• 握手消息的格式是否完全相同（比如有没有多余的空格、换行）
  找出差异后调整你的代码。

6. 尝试用现成SignalR库简化流程 #

虽然你试过两个库，但可以看看它们是否支持自定义认证逻辑。比如x2v3/signalr允许你配置自定义HTTP客户端，你可以在客户端中注入从10443端口获取的令牌，让库帮你处理握手细节，避免手动拼接URL和消息的错误。

修改后的示例代码 #

整合以上建议的完整代码片段：

import (
    "fmt"
    "net/http"
    "net/url"
    "github.com/gorilla/websocket"
)

func ConnectSignalR(connectionID, token, hubName string) (*websocket.Conn, error) {
    // 编码connectionData
    connectionData := fmt.Sprintf(`[{"name":"%s"}]`, hubName)
    encodedConnData := url.QueryEscape(connectionData)

    // 构建WebSocket URL
    u := url.URL{
        Scheme:   "wss",
        Host:     "server:10446",
        Path:     "/endpoint",
        RawQuery: fmt.Sprintf("transport=WebSockets&id=%s&connectionData=%s", connectionID, encodedConnData),
    }

    // 设置请求头
    headers := http.Header{}
    headers.Add("X-Requested-With", "XMLHttpRequest")
    headers.Add("Authorization", "Bearer "+token)
    headers.Add("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36")

    // 建立WebSocket连接
    ws, resp, err := websocket.DefaultDialer.Dial(u.String(), headers)
    if err != nil {
        return nil, fmt.Errorf("拨号失败：%w，响应状态：%s", err, resp.Status)
    }

    // 发送握手消息
    handshakeMsg := []byte(`{"protocol": "json","version": 1}`)
    if err = ws.WriteMessage(websocket.TextMessage, handshakeMsg); err != nil {
        ws.Close()
        return nil, fmt.Errorf("发送握手消息失败：%w", err)
    }

    // 读取握手响应
    _, respMsg, err := ws.ReadMessage()
    if err != nil {
        ws.Close()
        return nil, fmt.Errorf("读取握手响应失败：%w", err)
    }
    fmt.Println("握手成功，服务器响应：", string(respMsg))

    return ws, nil
}

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