Go问答：json.RawMessage怎样延迟解析不同结构的 JSON 字段为什么结果为空或不符合预期

当一个 JSON 接口的 payload 会随着 kind 变化时，直接把它声明成 any 往往会得到 map[string]any、[]any 和浮点数等不够稳定的结果。更适合的做法是先用 json.RawMessage 接住原始 JSON 字节，等外层字段解析完成后，再按照 kind 选择具体结构体进行第二次解析。

结果为空通常不是 RawMessage 没有工作，而是字段没有映射到、输入真的缺失、输入是显式 null，或者二次解析时选择了错误的目标类型。下面把这几种状态拆开，并给出一套可复用的写法。

官方资料：https://pkg.go.dev/encoding/json

先确认 RawMessage 字段确实被映射

json.RawMessage 的本质是保存一段原始 JSON 编码的字节。外层解码时，稳定字段可以直接落到结构体，结构不稳定的字段则先保留在 Payload 中。字段必须是导出的，并且建议用明确的 json 标签把外部字段名固定下来：

package main

import (
    "encoding/json"
    "fmt"
)

type Envelope struct {
    Kind    string          `json:"kind"`
    Request string          `json:"request"`
    Payload json.RawMessage `json:"payload"`
}

func main() {
    input := []byte(`{"kind":"user","request":"r-17","payload":{"id":7,"name":"小林"}}`)

    var envelope Envelope
    if err := json.Unmarshal(input, &envelope); err != nil {
        // 外层 JSON 损坏时，先返回外层错误，不要继续猜 payload 的结构。
        fmt.Println("外层解析失败:", err)
        return
    }

    // RawMessage 仍然保存 payload 的原始 JSON，稍后再决定目标类型。
    fmt.Printf("kind=%s request=%s payload=%s\n", envelope.Kind, envelope.Request, envelope.Payload)
}

如果 Payload 是小写字段，或者标签写成了与输入不同的字段名，它就可能保持零值。对 RawMessage 来说，零值通常表现为 nil 或长度为 0；这和输入里明确写了 "payload":null 不是同一种状态。

按 kind 保留原始字节并选择目标结构

实际接口通常有一个稳定的路由字段，例如 kind。先解析 kind，再把同一段 RawMessage 解码到不同结构体，可以避免把不确定数据过早降级为通用 map。

package main

import (
    "encoding/json"
    "fmt"
)

type Envelope struct {
    Kind    string          `json:"kind"`
    Payload json.RawMessage `json:"payload"`
}

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

type MetricPayload struct {
    Value float64 `json:"value"`
    Unit  string  `json:"unit"`
}

func decodePayload(input []byte) (any, error) {
    var envelope Envelope
    if err := json.Unmarshal(input, &envelope); err != nil {
        // 外层结构失败时，错误上下文应保留在外层。
        return nil, fmt.Errorf("解析 envelope: %w", err)
    }

    if len(envelope.Payload) == 0 {
        // 字段缺失时不进入具体结构体，避免把零值误当业务数据。
        return nil, fmt.Errorf("kind=%q 缺少 payload", envelope.Kind)
    }

    switch envelope.Kind {
    case "user":
        var payload UserPayload
        if err := json.Unmarshal(envelope.Payload, &payload); err != nil {
            // kind 与 payload 形状不一致时，返回二次解析错误。
            return nil, fmt.Errorf("解析 user payload: %w", err)
        }
        return payload, nil
    case "metric":
        var payload MetricPayload
        if err := json.Unmarshal(envelope.Payload, &payload); err != nil {
            // 不要吞掉类型错误，否则调用方只会看到一个空结构体。
            return nil, fmt.Errorf("解析 metric payload: %w", err)
        }
        return payload, nil
    default:
        // 未知 kind 先拒绝，比静默返回 map 更容易发现协议变更。
        return nil, fmt.Errorf("未知 kind=%q", envelope.Kind)
    }
}

func main() {
    input := []byte(`{"kind":"metric","payload":{"value":12.5,"unit":"ms"}}`)
    value, err := decodePayload(input)
    if err != nil {
        fmt.Println("解析失败:", err)
        return
    }
    fmt.Printf("%T: %+v\n", value, value)
}

这里的关键顺序是“外层一次、分支一次”。RawMessage 不会自动替你判断目标结构，也不会因为 kind 改变就自动转换；它只把选择权留到业务代码中。若服务端给出的字段形状可能变化，建议让每个分支都返回带上下文的错误。

区分缺失、null、合法对象和错误形状

排查“结果为空”时，先不要直接打印结构体。应同时观察原始字段的长度和内容，因为四种输入会得到不同结果：

特别要注意：空对象 {} 不是字段缺失。它可能成功解码成一个字段全是零值的结构体；如果业务需要区分“没有数据”和“数据为空”，要在结构体之外保留输入状态，不能只看二次解析后的字段值。

为什么二次解析后字段还是空

如果 RawMessage 有内容，但目标结构体字段仍是零值，优先按下面顺序排查：

1. 目标字段是否导出。 Go 的 JSON 解码只能写入可设置的导出字段，字段名小写时不会得到输入值。
2. 标签是否对应实际 JSON。 比如输入是 user_id，目标字段却没有 json:"user_id" 标签，字段映射就可能不符合预期。
3. kind 与结构是否配套。 把数组交给对象结构体，或者把字符串交给数值字段，二次解析会返回错误；不要只打印目标结构体。
4. 是否复用了旧变量。 在循环中重复 Unmarshal 到同一个非零结构体时，容易把前一次状态带进下一次判断。每次分支都创建新的目标变量，或显式清空它。
5. 是否把 null 当作空对象。 对指针、切片和 map 等目标类型，null 可能表现为 nil；这代表输入是 null，而不是解析失败。

可以给二次解析加一层明确的错误包装，让日志同时带上 kind 和目标分支。这样看到“字段为空”时，先能确认是没有进入分支、输入为空，还是目标类型不匹配。

把 RawMessage 解析路径固定成检查清单

这类代码适合集中在一个小函数中处理，调用方只接收具体类型和错误。发布或改接口前，可以按下面的清单复查：

• 外层结构体字段是导出的，并且对不稳定字段使用了明确的 json:"payload" 标签。
• 先检查 len(raw) 判断字段是否缺失，再决定是否允许显式 null。
• 使用稳定的 kind 或类似路由字段选择目标结构，而不是猜测 JSON 形状。
• 每次二次 json.Unmarshal 都检查错误，并将目标分支写入错误上下文。
• 空对象、空数组、null 和字段缺失有不同业务含义时，保留原始状态。
• 服务端新增 kind 时让默认分支显式报错，避免未知数据悄悄变成空结构。

可以把核心原则记成一句话：RawMessage 负责延迟决定，kind 负责选择目标，Unmarshal 错误负责说明不匹配。 只要把这三个职责分开，结果为空的问题通常都能落到具体输入状态，而不是停留在“JSON 没解析出来”的模糊结论上。

相关问题

字段缺失和 payload 为 null 怎么区分？

字段缺失时 RawMessage 通常是 nil 或长度为 0；显式 null 会保留 null 这几个字节。先检查长度，再根据原始内容判断是否为 null。

可以先把 RawMessage 转成 map[string]any 吗？

可以，但这样会失去具体结构体的类型约束，数字等值也可能落成通用类型。结构稳定或有明确 kind 时，优先直接二次解析到目标结构体。

二次解析失败时应该返回空结构体吗？

不建议。空结构体可能被误当成成功结果，应返回带 kind 和目标类型上下文的错误，让调用方区分协议错误与合法零值。