本文介绍使用 `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"`
}

解码时分两步：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

1. 先解码顶层 Message，获取 Cmd 值；
2. 根据 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 的标准实践。