如何将JSON反序列化为含多层结构体映射的Go结构体？

你完全不需要手动用临时结构体循环调用make()来初始化映射——Go 标准库的encoding/json包本身就支持自动处理嵌套映射的反序列化，直接使用json.Unmarshal就能完成，非常简洁。

核心原理 #

当你把 JSON 数据反序列化到包含map字段的结构体时，如果 JSON 中对应位置是对象类型，encoding/json会自动创建对应的map实例，不需要你提前调用make()初始化。即使某个层级的字段在 JSON 中不存在，结构体里的map字段会保持零值（nil），如果需要避免nil，可以通过构造函数或自定义反序列化来处理。

直接反序列化示例 #

假设你有如下 JSON 数据：

{
  "Markets": {
    "market1": {
      "Products": {
        "prod1": {"ID": 1},
        "prod2": {"ID": 2}
      }
    },
    "market2": {}
  }
}

直接使用json.Unmarshal反序列化到你的Event结构体即可：

package main

import (
  "encoding/json"
  "fmt"
)

type Event struct {
  Markets map[string]Market `json:"Markets"`
}
type Market struct {
  Products map[string]Product `json:"Products"`
}
type Product struct {
  ID int `json:"ID"`
  // 其他字段...
}

func main() {
  jsonData := []byte(`{
    "Markets": {
      "market1": {
        "Products": {
          "prod1": {"ID": 1},
          "prod2": {"ID": 2}
        }
      },
      "market2": {}
    }
  }`)

  var event Event
  if err := json.Unmarshal(jsonData, &event); err != nil {
    panic(err)
  }

  // 直接使用反序列化后的结果
  fmt.Printf("Market1 Product1 ID: %d\n", event.Markets["market1"].Products["prod1"].ID)
  // 即使market2没有Products字段，Products是nil，判断后即可安全操作
  if products := event.Markets["market2"].Products; products != nil {
    // 处理逻辑
  }
}

避免 nil map 的优化方案 #

如果希望所有层级的map默认都是空映射（而非nil），可以给结构体添加构造函数：

func NewEvent() *Event {
  return &Event{
    Markets: make(map[string]Market),
  }
}

func NewMarket() Market {
  return Market{
    Products: make(map[string]Product),
  }
}

使用时先初始化结构体，再反序列化：

event := NewEvent()
// 反序列化会自动填充已有map中的数据，空map会保留
json.Unmarshal(jsonData, event)

自定义反序列化（进阶） #

如果需要强制所有层级的map都被初始化为空，即使 JSON 中完全没有对应字段，可以自定义UnmarshalJSON方法：

func (e *Event) UnmarshalJSON(data []byte) error {
  // 定义临时结构体，和Event结构一致
  type tmpEvent Event
  var tmp tmpEvent
  if err := json.Unmarshal(data, &tmp); err != nil {
    return err
  }

  // 初始化所有map字段
  if tmp.Markets == nil {
    tmp.Markets = make(map[string]Market)
  }
  for k := range tmp.Markets {
    if tmp.Markets[k].Products == nil {
      tmp.Markets[k].Products = make(map[string]Product)
    }
  }

  *e = Event(tmp)
  return nil
}

这样无论 JSON 中是否包含对应字段，Event及其嵌套的Market中的map都会被初始化为空映射，后续操作无需判断nil。

内容的提问来源于stack exchange，提问作者0lly