如何在 Go 中实现 JSON 的部分解码与更新（保留未知字段）

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《如何在 Go 中实现 JSON 的部分解码与更新（保留未知字段） 》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

本文介绍使用 json.RawMessage 与自定义 UnmarshalJSON/MarshalJSON 方法，在不丢失原始 JSON 中未知字段的前提下，安全地读取、修改并重写指定字段的完整实践方案。

在 Go 开发中，常遇到需要更新 JSON 中某几个已知字段，却无法预知或不关心其余结构的场景——例如配置文件热更新、API 响应透传增强、微服务间 JSON 数据桥接等。若直接使用标准 encoding/json 包配合结构体，未声明的字段会在反序列化时被忽略，再序列化时彻底丢失，导致数据截断。

理想的解决方案是：“按需解析，全量保留，精准更新”。Go 提供了 json.RawMessage 类型，它能将任意 JSON 片段以字节形式延迟解析，正是实现该目标的关键。结合自定义的 UnmarshalJSON 和 MarshalJSON 方法，我们可构建一个“半结构化”类型，既支持强类型的字段访问，又确保原始 JSON 的完整性。

以下是一个典型实现示例：

package main

import (
    "encoding/json"
    "log"
)

type Color struct {
    Space string                    // 已知需操作的字段（强类型）
    raw   map[string]json.RawMessage // 保存全部原始键值对（含未知字段）
}

// UnmarshalJSON 先完整解析为 map[string]RawMessage，
// 再从中提取已知字段（如 Space），其余字段保留在 raw 中
func (c *Color) UnmarshalJSON(data []byte) error {
    var raw map[string]json.RawMessage
    if err := json.Unmarshal(data, &raw); err != nil {
        return err
    }
    c.raw = raw // 保留全部原始字段

    // 按需解析已知字段
    if spaceBytes, ok := c.raw["Space"]; ok {
        if err := json.Unmarshal(spaceBytes, &c.Space); err != nil {
            return err
        }
    }
    return nil
}

// MarshalJSON 先将已知字段序列化回 raw 映射，
// 再整体编码为 JSON，确保未知字段（如 Point）不丢失
func (c *Color) MarshalJSON() ([]byte, error) {
    if c.raw == nil {
        c.raw = make(map[string]json.RawMessage)
    }
    // 同步更新已知字段到 raw 中
    spaceBytes, err := json.Marshal(c.Space)
    if err != nil {
        return nil, err
    }
    c.raw["Space"] = json.RawMessage(spaceBytes)
    return json.Marshal(c.raw)
}

func main() {
    before := []byte(`{"Space": "YCbCr", "Point": {"Y": 255, "Cb": 0, "Cr": -10}}`)
    log.Println("before: ", string(before))

    color := new(Color)
    if err := json.Unmarshal(before, color); err != nil {
        log.Fatal(err)
    }

    // 安全修改业务字段（仅 Space 变更）
    color.Space = "RGB"

    after, err := json.Marshal(color)
    if err != nil {
        log.Fatal(err)
    }
    log.Println("after:  ", string(after))
}

运行结果验证了核心目标达成：

before:  {"Space": "YCbCr", "Point": {"Y": 255, "Cb": 0, "Cr": -10}}
after:   {"Point":{"Y":255,"Cb":0,"Cr":-10},"Space":"RGB"}

✅ 优势总结：

• 零字段丢失：所有未声明字段（如 "Point"）全程以 json.RawMessage 形式保留；
• 类型安全：关键字段（如 Space）仍享受 Go 类型系统保护与编译期检查；
• 灵活扩展：新增已知字段只需在结构体中添加字段 + 在 UnmarshalJSON/MarshalJSON 中补充解析逻辑；
• 内存友好：相比 map[string]interface{}，json.RawMessage 避免了重复解析与反射开销。

⚠️ 注意事项：

• json.RawMessage 不保证键顺序（Go map 无序），若需严格保持原始键序（如兼容某些校验逻辑），需改用有序映射（如 github.com/goccy/go-json 或自定义 slice+map 组合）；
• 不支持 JSON 注释或格式化（缩进/换行），输出为紧凑格式；
• 若需深度嵌套字段的部分更新（如 Point.Y），可将对应子结构也定义为嵌套类型并复用相同模式，或使用 gjson/sjjson 等第三方库进行路径式操作；
• 所有自定义 MarshalJSON 方法必须处理 nil 边界情况（示例中已补充 if c.raw == nil 判断）。

该方案平衡了灵活性与安全性，是 Go 生态中处理“动态 JSON + 静态契约”混合场景的经典范式。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~