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

本文讲解 go 中解析 json 到自定义结构体的正确方式，指出直接使用 `interface{}` 作为中间类型再强制转换会导致类型断言失败的根本原因，并推荐通过传入结构体指针实现零错误、高可读的解码流程。

在 Go 中，json.Unmarshal 将 JSON 数据反序列化为 interface{} 时，实际生成的是一个由基础类型（如 map[string]interface{}、[]interface{}、string、float64 等）构成的嵌套结构，而非你定义的具名结构体类型。因此，即使 JSON 内容与 person 字段完全匹配，actualInterface 的底层类型仍是 map[string]interface{}，而非 person —— 这就是 actualInterface.(person) 永远返回 false 的根本原因。

正确的做法是绕过 interface{} 中间层，直接将目标结构体变量的地址传给 json.Unmarshal。这不仅避免了运行时类型断言的不确定性，还提升了性能与类型安全性。以下是推荐实现：

package main

import (
    "encoding/json"
    "fmt"
)

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"`
    }
    jsonStr := `{"Name": "James", "Age": 22}`

    var p person
    err := FromJson(jsonStr, &p)
    if err != nil {
        fmt.Printf("JSON 解析失败: %v\n", err)
        return
    }

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

⚠️ 注意事项：

• 结构体字段必须是导出字段（首字母大写），否则 json.Unmarshal 无法赋值；
• 建议添加 json 标签（如 `json:"Name"`）以明确映射关系，提升健壮性（尤其当 JSON 键名与 Go 字段名不一致时）；
• FromJson 函数应始终检查并返回 error，不可忽略解析失败场景；
• 若需支持多种结构体类型，该函数已具备泛型兼容性（Go 1.18+ 可进一步升级为泛型版本，但当前签名已足够通用）。

总结：不要把 interface{} 当作“万能中转站”去承载结构化数据；而是让 json.Unmarshal 直接作用于目标类型的指针——这是 Go 生态中处理 JSON 的惯用、安全且高效的方式。