Golang JSON.RawMessage的使用场景

在使用Golang的json.RawMessage时，有哪些典型的应用场景？它和直接使用结构体解析JSON相比有什么优势？在什么情况下应该优先选择RawMessage而不是直接解析？能否举例说明它在处理动态JSON数据或延迟解析时的实际用法？

2 回复

Golang的json.RawMessage主要用于延迟JSON解析，常见场景包括：

  1. 中间代理处理：当需要转发JSON数据但不确定结构时，可直接用RawMessage暂存原始数据，避免重复序列化开销。

  2. 动态JSON结构：处理包含未知字段的JSON时，可先用RawMessage接收，再根据其他字段决定如何解析。

  3. 性能优化：若只需提取部分字段，可先解析已知字段，剩余部分用RawMessage保留，减少不必要的解析操作。

  4. 组合JSON：将多个RawMessage合并为新JSON，适用于消息聚合或数据中继场景。

示例：

type Message struct {
    Type string          `json:"type"`
    Data json.RawMessage `json:"data"` // 根据Type决定后续解析方式
}

注意：需手动调用Unmarshal解析具体内容，适合对性能有要求或处理异构数据的场景。

更多关于Golang JSON.RawMessage的使用场景的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


json.RawMessage 是 Go 语言 encoding/json 包中的一个类型，本质上是 []byte 的别名。它的主要使用场景如下：

主要使用场景

1. 延迟解析/条件解析 JSON

当 JSON 结构中某些字段需要根据其他字段的值来决定如何解析时：

type Message struct {
    Type string          `json:"type"`
    Data json.RawMessage `json:"data"`
}

func processMessage(raw []byte) error {
    var msg Message
    if err := json.Unmarshal(raw, &msg); err != nil {
        return err
    }
    
    switch msg.Type {
    case "text":
        var textData TextData
        json.Unmarshal(msg.Data, &textData)
        // 处理文本数据
    case "image":
        var imageData ImageData
        json.Unmarshal(msg.Data, &imageData)
        // 处理图片数据
    }
    return nil
}

2. 保留原始 JSON 数据

需要保留某些字段的原始 JSON 格式，用于日志、转发或后续处理：

type APIResponse struct {
    Status  int             `json:"status"`
    Message string          `json:"message"`
    Data    json.RawMessage `json:"data"`
}

// 可以直接转发 Data 字段而不重新序列化
func forwardResponse(resp APIResponse) {
    // resp.Data 保持原始 JSON 格式
    sendToOtherService(resp.Data)
}

3. 中间层代理或网关

在 API 网关中接收上游服务的响应，然后选择性修改部分字段：

type ProxyResponse struct {
    Header map[string]string `json:"header"`
    Body   json.RawMessage   `json:"body"`
}

// 可以修改 Header 而保持 Body 不变

4. 数据库存储

将不确定结构的 JSON 数据原样存储到数据库：

type UserPreference struct {
    UserID string          `json:"user_id"`
    Prefs  json.RawMessage `json:"preferences"`
}

// 不同用户的 preferences 结构可能不同

优势

  • 性能：避免不必要的序列化/反序列化
  • 灵活性：支持多态数据结构
  • 完整性：保持原始数据格式不变

json.RawMessage 在处理异构数据、构建中间件或需要灵活 JSON 处理的场景中非常有用。

回到顶部