如何在 Go 中将嵌套 JSON 字段解码到结构体字段

先说一个常见需求：在 Go 里处理形如 {"first": {"href": "http://some/resources/1"}} 这种嵌套 JSON，然后想把最里层的 href 值直接映射到一个平铺的结构体字段上（比如 First string）。这事儿很常见，但标准库并不原生支持。

你可能会想，加个 json:"first.href" 不就行了？遗憾的是，Go 标准库的 encoding/json 并不解析点号（.）或嵌套路径。json 标签只认顶层字段名，你给它写个 json:"first.href"，它会当成一个叫 first.href 的字段去匹配，而不是先去解析 first，再找 href。结果就是字段始终为空。

那么，怎么解决这个痛点？下面给出几种靠谱的做法。

推荐方案：自定义 UnmarshalJSON

最直接、最可控、也最符合 Go 惯例的做法，就是为结构体实现 UnmarshalJSON 方法。思路很简单：先定义一个中间结构体，精确对应 JSON 的层级，然后在解码时手动把嵌套的值“拉平”赋值。

type MyStruct struct {  
    First  string  
    Second string  
    Third  string  
}  

func (m *MyStruct) UnmarshalJSON(data []byte) error {  
    // 定义中间结构体，精确对应 JSON 层级  
    var raw struct {  
        First  struct{ Href string } `json:"first"`  
        Second struct{ Href string } `json:"second"`  
        Third  struct{ Href string } `json:"third"`  
    }  
    if err := json.Unmarshal(data, &raw); err != nil {  
        return err  
    }  
    m.First = raw.First.Href  
    m.Second = raw.Second.Href  
    m.Third = raw.Third.Href  
    return nil  
}

使用起来也很简单：

bytes := []byte(`{  
  "first":  {"href":"http://some/resources/1"},  
  "second": {"href":"http://some/resources/2"},  
  "third":  {"href":"http://some/resources/3"}  
}`)  

var s MyStruct  
err := json.Unmarshal(bytes, &s)  
if err != nil {  
    log.Fatal(err)  
}  
fmt.Println(s.First)  // 输出: http://some/resources/1

这个方法的好处是：意图清晰，类型安全，完全可控，而且和标准库无缝配合。从实际工程角度来说，这属于最稳妥的“Go 之道”。

注意事项

• 别想着用反射去泛化解析。虽然第三方库（比如 gjson 或 mapstructure）可以动态提取路径，但代价是牺牲类型安全和性能。在结构固定的场景下，手写中间结构体反而更安全、更高效。
• 错误处理不能省。如果嵌套字段缺失（比如 first 不存在，或者 href 字段丢了），会让字段变成零值。如果需要严格校验，记得在解码后检查空字符串，或者补充额外的验证逻辑。
• 别在 json tag 上走弯路。试图用 json:"first.href" 是无效的，Go 会静默忽略这个路径，最终字段永远拿不到值。

替代方案：适用场景有限

如果字段实在太多，或者想复用逻辑，也可以封装一个通用的辅助函数：

func getHref(data []byte, key string) (string, error) {  
    var m map[string]map[string]string  
    if err := json.Unmarshal(data, &m); err != nil {  
        return "", err  
    }  
    if inner, ok := m[key]; ok {  
        return inner["href"]  
    }  
    return "", fmt.Errorf("key %q not found or href missing", key)  
}

但这种方式牺牲了类型安全，性能也一般，只建议在原型阶段或者配置类简单场景下使用。

话说回来，核心结论很明确：为结构体实现 UnmarshalJSON 是最 Go-idiomatic 的做法，可维护性强，健壮性好，值得长期采用。