本文介绍使用 `json.rawmessage` 实现 json 中可变数据字段的延迟解析，避免 `interface{}` 类型断言失败问题，支持按 `cmd` 字段灵活解码为具体结构体。
在 Go 中处理具有多态 data 字段的 JSON 消息（如不同命令对应不同数据结构）时，直接将 data 声明为 interface{} 虽然能完成初步解码，但后续类型转换会失败——因为 json.Unmarshal 将嵌套对象默认转为 map[string]interface{}，而非目标结构体。此时推荐采用 两阶段解码：先用 json.RawMessage 原样捕获未解析的 JSON 字节流，再依据 cmd 字段动态选择对应结构体进行二次解码。
核心做法是将 Message.Data 字段声明为 json.RawMessage 类型（本质是 []byte 的别名），它能跳过即时解析，保留原始 JSON 字节，避免类型丢失：
type Message struct {
Cmd string `json:"cmd"`
Data json.RawMessage `json:"data"` // 关键：延迟解析
}
type CreateMessage struct {
Conf map[string]int `json:"conf"`
Info map[string]int `json:"info"`
}解码时分两步：
- 先解码顶层 Message，获取 Cmd 值；
- 根据 Cmd 分支，将 Data（json.RawMessage）转为 []byte 后，再次 json.Unmarshal 到具体结构体：
func decodeMessage(data []byte) error {
var m Message
if err := json.Unmarshal(data, &m); err != nil {
return fmt.Errorf("failed to unmarshal message: %w", err)
}
switch m.Cmd {
case "create":
var cm CreateMessage
if err := json.Unmarshal(m.Data, &cm); err != nil {
return fmt.Errorf("failed to unmarshal create data: %w", err)
}
fmt.Printf("Create: %+v\n", cm)
case "update":
var um UpdateMessage
if err := json.Unmarshal(m.Data, &um); err != nil {
return fmt.Errorf("failed to unmarshal update data: %w", err)
}
fmt.Printf("Update: %+v\n", um)
default:
return fmt.Errorf("unsupported command: %s", m.Cmd)
}
return nil
}⚠️ 注意事项：
- json.RawMessage 必须是导出字段（首字母大写），否则 json 包无法访问；
- 二次解码时传入 m.Data 即可（无需 []byte(m.Data)，因 json.RawMessage 已实现 json.Unmarshaler 接口）；
- 若 data 字段可能为空或缺失，建议在 switch 前校验 len(m.Data) > 0；
- 对于高频场景，可封装通用解码器函数，结合 reflect.Type 或接口注册表提升可维护性。
该方案兼顾类型安全与灵活性，是 Go 处理异构 JSON API 的标准实践。
