本文介绍使用 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 + 静态契约”混合场景的经典范式。
