Go RawMessage 为什么二次解析后字段为空

我遇到过一种很容易误判的 Go JSON 问题：外层结构体能正常解析，json.RawMessage 也没有报错，但第二次解析到具体结构体后，字段却全是零值。多数时候不是 RawMessage “丢数据”，而是它保存的 JSON 层级、外层字段标签或二次解析目标没有对上。

先确认 RawMessage 里到底是什么

RawMessage 的定位是延迟解析的 JSON 字节。它可能是对象、数组、字符串，甚至是 null。所以第一步不要直接盯着结果结构体，先看原始内容和长度：

package main

import (
    "encoding/json"
    "fmt"
)

type Envelope struct {
    Kind string          `json:"kind"`
    Data json.RawMessage `json:"data"`
}

func inspect(raw []byte) error {
    var env Envelope
    if err := json.Unmarshal(raw, &env); err != nil {
        return fmt.Errorf("解析外层 Envelope 失败: %w", err)
    }

    // 先确认字段是否命中，再决定后续要解析成对象还是数组。
    fmt.Printf("kind=%q data-bytes=%d data=%s\n", env.Kind, len(env.Data), env.Data)
    if len(env.Data) == 0 || string(env.Data) == "null" {
        return fmt.Errorf("data 没有可供二次解析的 JSON")
    }
    return nil
}

这里最有价值的不是打印内容本身，而是把“外层解析失败”和“动态字段为空”分开。若 data-bytes=0，优先检查 json:"data" 是否写对，以及输入是否实际使用了 payload、result 等其他键；若内容是对象但字段仍为空，问题才进入目标结构体匹配阶段。

外层字段命中后，再核对二次解析目标

假设不同事件的 data 结构不同，可以先读 kind，再选择对应的结构体。关键点是传入指针；传值不会把解析结果写回调用方。

type UserCreated struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

type OrderPaid struct {
    OrderID string `json:"order_id"`
    Amount  int64  `json:"amount"`
}

func decodeData(env Envelope) (any, error) {
    switch env.Kind {
    case "user.created":
        var v UserCreated
        // 传入 &v，Unmarshal 才能把字段写进这个目标值。
        if err := json.Unmarshal(env.Data, &v); err != nil {
            return nil, fmt.Errorf("解析 user.created.data 失败: %w", err)
        }
        return v, nil
    case "order.paid":
        var v OrderPaid
        // order_id 与 amount 必须和 JSON 键或标签对应，类型也要兼容。
        if err := json.Unmarshal(env.Data, &v); err != nil {
            return nil, fmt.Errorf("解析 order.paid.data 失败: %w", err)
        }
        return v, nil
    default:
        return nil, fmt.Errorf("不支持的 kind: %s", env.Kind)
    }
}

如果 env.Data 是 {"id":7,"name":"Lin"}，却拿 OrderPaid 接收，标准库可能不会因为未知字段而报错，只会得到一个看似“成功”但字段为空的结构体。必要时可以对第二次解析使用 json.Decoder 并开启 DisallowUnknownFields，把目标类型选错尽早变成明确错误。

字段为空时的排查清单

还有一个常见坑是把错误丢掉：

var result UserCreated
if err := json.Unmarshal(env.Data, &result); err != nil {
    // 记录 kind 和错误，避免把类型不匹配伪装成业务零值。
    return fmt.Errorf("kind=%s 二次解析失败: %w", env.Kind, err)
}

需要注意，JSON 对象中不存在的字段本来就会保留 Go 零值；JSON 的 null 对普通数值、字符串字段也不会自动产生错误。因此“没有报错”只说明语法和部分类型检查通过，不等于业务字段已经完整。

把动态载荷解析收敛到一个边界

生产代码里，我会把 RawMessage 的检查、kind 分派和错误包装放在同一个函数中，调用方只接收已经确定类型的结果。这样日志至少能回答三个问题：收到的 kind 是什么、原始 data 是否为空、失败发生在外层还是具体类型。

如果协议允许未知事件，保留 RawMessage 并返回“未支持 kind”通常比强行解成 map[string]any 更稳；如果协议固定且字段必须齐全，则可以在目标结构体上补业务校验，避免把 JSON 默认零值当成真实数据。

相关问题

RawMessage 需要手动复制吗？

标准库的 RawMessage.UnmarshalJSON 会把传入数据复制到消息中，适合延迟到后续分派；但仍应把它视为 JSON 字节，而不是已经填充好的业务对象。

为什么改成 map[string]any 后能看到字段？

因为 map 不要求预先匹配结构体字段，但数字默认会落成 float64，也失去了编译期字段约束。它适合临时观察，不一定适合作为最终模型。

二次解析总是报类型错误怎么办？

先保留完整的 UnmarshalTypeError 上下文，确认 JSON 中该字段到底是字符串、数字、对象还是数组，再修改目标结构体或协议映射，不要只把字段改成 any 来掩盖问题。