本文详解 `json.unmarshal()` 使用中因错误处理不当导致的“invalid memory address or nil pointer dereference”崩溃问题，并提供基于 `json.decoder` 和 websocket 专用 api 的健壮替代方案。
在 Go 中解析 JSON 时，一个常见却隐蔽的陷阱是：对 nil 错误值调用 .Error() 方法。回顾原始代码：
err := json.Unmarshal(message[:n], &command)
fmt.Printf("Received command: %v (Error: %s)\n", command, err.Error()) // ⚠️ 危险！当 json.Unmarshal() 成功执行时，err 为 nil；此时调用 err.Error() 会触发运行时 panic —— 正是日志中 invalid memory address or nil pointer dereference 的根源。修复方式很简单：直接传入 err（fmt 会自动处理 nil），或显式判空：
fmt.Printf("Received command: %v (Error: %v)\n", command, err) // ✅ 安全
// 或更严谨地：
if err != nil {
log.Printf("JSON decode failed: %v", err)
continue
}但更深层的问题在于 I/O 边界与协议语义不匹配。原始代码使用 s.Read(message) 读取固定长度字节，但 WebSocket 消息是完整帧（frame-based），而 Read() 可能只读到部分 JSON（如截断的 {"gruss":"Hello），或一次读取多个消息（粘包）。这会导致 json.Unmarshal() 解析失败，且错误难以调试。
✅ 推荐方案一：使用 json.Decoder（流式、自动处理边界）
json.NewDecoder(s) 封装了底层读取逻辑，能正确识别 JSON 值的起止（支持对象、数组等多类型），天然适配流式场景：
立即学习“go语言免费学习笔记（深入）”；
func translateMessages(s socket) {
decoder := json.NewDecoder(s)
for {
fmt.Printf("Waiting for a message ... \n")
var command map[string]interface{}
if err := decoder.Decode(&command); err != nil {
log.Printf("Decode error: %v", err)
return // 或 break/continue，依业务决定
}
fmt.Printf("Received command: %v\n", command)
}
}✅ 推荐方案二：WebSocket 场景专用 —— 使用 gorilla/websocket 的 ReadJSON
若基于 WebSocket（如 gorilla/websocket），应直接使用其提供的结构化读取方法，它已封装帧解析、UTF-8 验证和 JSON 解码：
import "github.com/gorilla/websocket"
func translateMessages(conn *websocket.Conn) {
for {
fmt.Printf("Waiting for a message ... \n")
var command map[string]interface{}
if err := conn.ReadJSON(&command); err != nil {
log.Printf("ReadJSON failed: %v", err)
return
}
fmt.Printf("Received command: %v\n", command)
}
}? 关键注意事项：
- 永远不要对可能为 nil 的 error 调用 .Error()；优先用 %v 格式化，或先判空；
- 避免手动管理缓冲区读取 JSON：Read() + Unmarshal() 组合易出错，应交由 json.Decoder 或协议专用 API 处理；
- 生产环境务必添加错误恢复与日志：WebSocket 连接中断、非法 JSON、超大消息等均需优雅降级；
- 若需高性能或强类型，建议定义结构体而非 map[string]interface{}，提升可读性与安全性。
通过以上改进，不仅能消除 panic，更能构建出符合网络协议特性的健壮 JSON 处理流程。
