如何在 Go 中正确将 JSON 解析为自定义结构体而不依赖类型断言

霞舞 2025-12-30 00:00:00 次阅读

本文详解 go 中 `interface{}` 无法直接赋值给结构体的常见错误原因，并提供安全、高效、符合 go 惯例的解决方案：通过传入结构体指针让 `json.unmarshal` 直接填充目标变量，彻底避免运行时类型断言失败风险。

在 Go 中，当你使用 json.Unmarshal 解析 JSON 到 interface{} 类型时，它会根据 JSON 数据结构自动构建一个由 map[string]interface{}、[]interface{}、基本类型（如 string、float64、bool）组成的嵌套动态结构——而非你定义的具名结构体。因此，即使 JSON 内容与 person 结构体字段完全匹配，actualInterface 的底层类型仍是 map[string]interface{}，而非 person。这就是为什么直接赋值 actual = actualInterface 报错：

cannot use type interface {} as type person in assignment: need type assertion

而类型断言 actualInterface.(person) 也必然失败，因为运行时该接口值根本不是 person 类型实例，而是 map[string]interface{}。

✅ 正确做法是：让 json.Unmarshal 直接解码到目标结构体变量的地址上，而非先解析为 interface{} 再尝试转换。这不仅类型安全、零分配开销，还符合 Go 标准库的设计哲学。

以下是推荐实现方式：

package main

import (
    "encoding/json"
    "fmt"
)

// FromJson 接收一个可写入的指针 v，直接将 JSON 解析到其指向的变量中
func FromJson(jsonSrc string, v interface{}) error {
    return json.Unmarshal([]byte(jsonSrc), v)
}

func main() {
    type person struct {
        Name string `json:"Name"`
        Age  int    `json:"Age"`
    }
    jsonData := `{"Name": "James", "Age": 22}`

    var p person
    if err := FromJson(jsonData, &p); err != nil {
        panic(err) // 或妥善处理错误
    }

    fmt.Printf("Parsed: %+v\n", p) // 输出：Parsed: {Name:James Age:22}
}