Go WebSockets 二进制协议中 uint64 写入与读取的正确方式-Golang-PHP中文网

Go WebSockets 二进制协议中 uint64 写入与读取的正确方式

本文详解 go websocket 通信中使用 binary.write 写入 uint64 后，为何用 binary.readuvarint 读取会导致值为 0，并提供完整、可复用的二进制消息编解码方案。

本文详解 go websocket 通信中使用 binary.write 写入 uint64 后，为何用 binary.readuvarint 读取会导致值为 0，并提供完整、可复用的二进制消息编解码方案。

在 Go 中通过 WebSocket（如 Gorilla WebSocket）传输结构化二进制数据时，常见的误区是混用固定长度整数（如 uint64）与变长整数（uvarint）的序列化/反序列化方法。您代码中写入的是两个严格 8 字节的 uint64 值：

binary.Write(buff, binary.LittleEndian, uint64(1))        // 占 8 字节
binary.Write(buff, binary.LittleEndian, uint64(len(message))) // 占 8 字节
binary.Write(buff, binary.LittleEndian, message)          // 原始字节

但接收端却使用：

t, err := binary.ReadUvarint(buffer) // ❌ 错误：uvarint 编码长度可变（1–10 字节），且不兼容 little-endian uint64 的二进制布局

binary.ReadUvarint 期望的是 Google Protocol Buffers 风格的变长整数编码（MSB 标志位 + 7-bit 数据块），而 binary.Write(..., uint64) 输出的是标准 8 字节小端序原始二进制。二者完全不兼容——这正是您读到 0 的根本原因：ReadUvarint 在首字节非 uvarint 格式时会立即失败或返回 0（具体行为依赖底层解析逻辑）。

WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。

下载

✅ 正确做法：写什么，就用对应方式读什么。若写入 uint64，则必须用 binary.Read + 指针读取：

// ✅ 接收端：按顺序读取两个 uint64
var msgType, payloadLen uint64
if err := binary.Read(buffer, binary.LittleEndian, &msgType); err != nil {
    utils.Log("failed to read message type:", err)
    return
}
if err := binary.Read(buffer, binary.LittleEndian, &payloadLen); err != nil {
    utils.Log("failed to read payload length:", err)
    return
}

// 然后读取指定长度的有效载荷
payload := make([]byte, payloadLen)
if _, err := io.ReadFull(buffer, payload); err != nil {
    utils.Log("failed to read payload:", err)
    return
}

// 示例：解析 JSON 数据
var rooms []*Room
if err := json.Unmarshal(payload, &rooms); err != nil {
    utils.Log("JSON unmarshal failed:", err)
    return
}
utils.Log("received", len(rooms), "rooms")

⚠️ 注意事项：