Go中避免json.Unmarshal nil指针错误的方法

本文详解Go中json.Unmarshal引发“invalid memory address or nil pointer dereference”崩溃的根本原因——误调用nil错误值的Error()方法，并提供安全解码、流式解析及WebSocket场景下的最佳实践。

在Go语言中，json.Unmarshal() 本身不会直接导致 nil 指针解引用 panic；真正触发崩溃的是后续对可能为 nil 的 error 值调用 .Error() 方法。观察原始代码：

err := json.Unmarshal(message[:n], &command)
fmt.Printf("Received command: %v (Error: %s)\n", command, err.Error()) // ⚠️ 危险！当 err == nil 时 panic

当 JSON 解析成功时，err 为 nil，此时 err.Error() 会引发运行时 panic：“invalid memory address or nil pointer dereference”。这是 Go 中常见的错误模式——未判空即调用 error 方法。

✅ 正确做法是：始终用 %v 格式化 error（fmt 包对 nil error 安全输出 ），或显式判空：

err := json.Unmarshal(message[:n], &command)
if err != nil {
    fmt.Printf("JSON decode failed: %v\n", err)
    continue // 或处理错误
}
fmt.Printf("Received command: %v (Error: %v)\n", command, err) // ✅ 安全

更进一步，原始代码还存在协议层隐患：s.Read(message) 是底层字节读取，无法保证一次读取恰好构成一个完整、合法的 JSON 对象（尤其在 WebSocket 或 TCP 流中，消息可能被拆分或粘连）。手动切片 message[:n] 并直接解析，极易因不完整 JSON 导致 Unmarshal 返回语法错误（如 invalid character），但根本问题仍是错误处理不健壮。

? 推荐采用流式解码器（json.Decoder），它能自动处理分块数据、按 JSON token 边界解析，大幅提升鲁棒性：

func translateMessages(s socket) {
    decoder := json.NewDecoder(s) // 绑定到 io.Reader（如 websocket 连接）
    for {
        fmt.Printf("Waiting for a message ... \n")
        var command map[string]interface{}
        if err := decoder.Decode(&command); err != nil {
            fmt.Printf("Decode error: %v\n", err)
            if errors.Is(err, io.EOF) || errors.Is(err, io.ErrUnexpectedEOF) {
                break // 连接关闭或异常终止
            }
            continue // 其他错误可选择重试或日志
        }
        fmt.Printf("Received command: %v\n", command)
    }
}

? 特别提醒：若实际使用 WebSocket（而非裸 socket），强烈建议采用 gorilla/websocket 等成熟库，直接利用其封装好的 JSON 方法：

// 使用 gorilla/websocket
func handleWebSocket(conn *websocket.Conn) {
    for {
        var command map[string]interface{}
        if err := conn.ReadJSON(&command); err != nil {
            log.Printf("ReadJSON error: %v", err)
            break
        }
        fmt.Printf("Received command: %v\n", command)
    }
}

ReadJSON 内部已集成 json.Decoder，并自动处理帧边界、UTF-8 验证、缓冲区管理，彻底规避手动读取与解析的陷阱。

✅ 总结关键实践：

• 永远不要对未判空的 error 调用 .Error()；优先用 %v 格式化；
• 避免手动 Read() + Unmarshal 组合，改用 json.NewDecoder(io.Reader).Decode() 处理流式数据；
• WebSocket 场景务必使用专用库（如 gorilla/websocket）的 ReadJSON/WriteJSON，而非底层字节操作；
• 在循环中加入明确的错误分支处理（如 io.EOF 判定），防止无限 panic 循环。

遵循以上原则，即可彻底消除此类 panic，并构建出稳定、可维护的 JSON 通信逻辑。