本文介绍使用 json.rawmessage 避免重复解析、按 section 名称动态解码 json 子对象到对应 go 结构体的实用方法，兼顾类型安全与扩展性。
本文介绍使用 json.rawmessage 避免重复解析、按 section 名称动态解码 json 子对象到对应 go 结构体的实用方法，兼顾类型安全与扩展性。
在 Go 中处理异构 JSON 消息（即同一顶层对象下包含多个结构不一的命名子段）时，常见的误区是先全量解析为 map[string]interface{}，再手动提取字段、类型断言、逐个赋值——这不仅冗长易错，还丧失了 json.Unmarshal 对结构体字段的自动绑定、零值填充、嵌套结构支持等优势。
幸运的是，Go 标准库提供了 json.RawMessage 类型，它本质上是一个 []byte 的别名，但关键特性在于：它能延迟 JSON 解析，允许你先按需提取某一段原始 JSON 字节，再单独对其执行类型化反序列化。这正是解决“只解析 JSON 中某个 subsection”需求的理想方案。
以下是一个完整、可运行的示例：
package main
import (
"encoding/json"
"fmt"
"log"
)
type Book struct {
Author string `json:"Author"`
Title string `json:"Title"`
Price float64 `json:"Price"`
}
type Movie struct {
Title string `json:"Title"`
Year int `json:"Year"` // 注意：原示例中为 float64，但年份更宜用 int
Stars float64 `json:"Stars"`
Format string `json:"Format"`
}
// 定义一个映射：section 名称 → 对应结构体指针
func unmarshalSection(sectionName string, data json.RawMessage, target interface{}) error {
return json.Unmarshal(data, target)
}
func main() {
incomingMsg := `
{
"Book": {
"Author": "Jack Kerouac",
"Title": "On the Road",
"Price": 5.99
},
"Movie": {
"Title": "Sherlock Holmes vs. the Secret Weapon",
"Year": 1940,
"Stars": 2.5,
"Format": "DVD"
}
}`
// 第一步：定义 sections 映射，key 为 section 名，value 为 RawMessage（保留原始字节）
type Sections map[string]json.RawMessage
var sections Sections
if err := json.Unmarshal([]byte(incomingMsg), §ions); err != nil {
log.Fatal("failed to unmarshal top-level sections:", err)
}
// 第二步：遍历每个 section，根据名称分发到对应结构体
for sectionName, rawJSON := range sections {
switch sectionName {
case "Book":
var book Book
if err := unmarshalSection(sectionName, rawJSON, &book); err != nil {
log.Printf("failed to unmarshal 'Book': %v", err)
continue
}
fmt.Printf("Parsed Book: %+v\n", book)
case "Movie":
var movie Movie
if err := unmarshalSection(sectionName, rawJSON, &movie); err != nil {
log.Printf("failed to unmarshal 'Movie': %v", err)
continue
}
fmt.Printf("Parsed Movie: %+v\n", movie)
default:
fmt.Printf("Unknown section '%s', skipping...\n", sectionName)
}
}
}
✅ 核心要点说明：
- json.RawMessage 不会立即解析内容，而是将对应 JSON 值（如 {...} 或 [...]）以原始字节形式缓存，因此可安全地多次复用或传递；
- 使用 map[string]json.RawMessage 直接解码顶层结构，避免了 interface{} 的繁琐类型断言和反射操作；
- 每个 section 可独立调用 json.Unmarshal(rawJSON, &target)，享受完整的结构体绑定能力（包括标签映射、嵌套结构、自定义 UnmarshalJSON 方法等）；
- 扩展性强：新增 section 类型只需在 switch 中添加分支，无需修改通用解析逻辑。
⚠️ 注意事项：
- json.RawMessage 必须作为字段值或 map value 使用，不能直接用于 json.Unmarshal 到普通结构体字段（除非该字段类型明确为 json.RawMessage）；
- 若 section 名称来自不可信输入，建议使用 map[string]json.RawMessage + 白名单校验，而非 eval 或反射构造类型名；
- 对于数十种 section 类型，可进一步封装为注册式工厂（如 RegisterSection("Book", func() interface{} { return &Book{} })），提升可维护性。
通过 json.RawMessage 实现“按需解码”，既保持了 Go 的静态类型优势，又规避了过度泛化带来的复杂度，是处理动态 JSON schema 场景的推荐实践。
