本文介绍在 go 应用中统一解析两种嵌套结构差异较大的 json 输入（一种含单本书，另一种含书库及多本书列表），通过嵌套匿名结构体与结构体组合实现类型安全、可读性强的一体化解析方案。
本文介绍在 go 应用中统一解析两种嵌套结构差异较大的 json 输入（一种含单本书，另一种含书库及多本书列表），通过嵌套匿名结构体与结构体组合实现类型安全、可读性强的一体化解析方案。
在实际开发中，API 接口常因版本演进或业务场景差异返回结构不一致但语义相关的 JSON 数据。例如本例中，服务端可能向同一端点返回两种格式：
-
格式 A：仅包含单本图书信息，嵌套于
book_data下； -
格式 B：除
book_data外，还包含books.data数组，表示多本书集合。
若强行用单一扁平结构体（如仅定义 Book）直接解码，会因字段缺失或嵌套层级不匹配而失败。Go 的标准库 encoding/json 提供了优雅的应对方式——利用结构体嵌套与匿名字段组合，在保持类型安全的同时，精准映射复杂、可变的 JSON 层级。
推荐采用如下结构定义：
type Book struct {
Title string `json:"title"`
PageNumber int `json:"page_number"`
}
type BookShelf struct {
BookData struct {
Book
Collection int `json:"collection,omitempty"`
} `json:"book_data"`
Books struct {
Data []Book `json:"data"`
} `json:"books,omitempty"`
}该设计的关键优势在于：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
-
BookData匿名内嵌Book，自动继承Title和PageNumber字段，同时可扩展专属字段（如Collection）； -
Books字段使用omitempty标签，使反序列化时即使 JSON 中不存在books字段也不会报错，且Data切片默认为空（而非 nil），便于后续安全遍历； - 整体结构清晰反映业务语义：
BookShelf表示一个“书架”，天然兼容单书（BookData）与多书（Books.Data）两种形态。
使用示例如下：
func parseBookInput(jsonBytes []byte) (*BookShelf, error) {
var shelf BookShelf
if err := json.Unmarshal(jsonBytes, &shelf); err != nil {
return nil, fmt.Errorf("failed to unmarshal: %w", err)
}
return &shelf, nil
}
// 调用示例
data1 := []byte(`{"book_data":{"title":"Go Programming","page_number":457}}`)
shelf1, _ := parseBookInput(data1)
fmt.Printf("Single book: %+v\n", shelf1.BookData.Book) // 输出 Book{Title: "Go Programming", PageNumber: 457}
data2 := []byte(`{"book_data":{"collection":214},"books":{"data":[{"title":"Go Programming","page_number":457},{"title":"Design Patterns","page_number":354}]}}`)
shelf2, _ := parseBookInput(data2)
fmt.Printf("Collection ID: %d\n", shelf2.BookData.Collection) // 214
fmt.Printf("Book count: %d\n", len(shelf2.Books.Data)) // 2⚠️ 注意事项：
- 若需严格区分两种输入格式（如做不同业务路由），可在解码后检查
shelf.Books.Data是否非空，或结合json.RawMessage做前置类型判断； - 避免过度依赖
map[string]interface{}，虽灵活但丧失编译期检查与 IDE 支持； - 对于更复杂的多态场景（如
book_data类型动态变化），可进一步结合json.RawMessage+ 条件解码，但本例中结构稳定，嵌套结构体已是最简最优解。
综上，合理运用 Go 结构体的组合与匿名嵌入特性，无需反射或运行时类型判断，即可实现高可读性、强健性与维护性的 JSON 解析逻辑。
