Go 中 JSON 反序列化失败的常见原因：结构体字段必须首字母大写导出

go 的 `json.unmarshal` 要求结构体字段必须是**导出（exported）字段**（即首字母大写），否则无法访问和赋值，导致反序列化静默失败（字段保持零值）。

在 go 语言中，encoding/json 包仅能对导出字段（即首字母大写的字段）进行序列化与反序列化操作。这是由 Go 的反射机制决定的：未导出字段（小写开头）在包外不可见，json 包无法通过反射读取或写入它们，因此即使 json 数据格式完全正确，反序列化后字段仍为零值（如空字符串 “”），且不会返回错误。

以你提供的代码为例：

type google_JSON struct {     code        string `json:"code"`        // ❌ 小写开头 → 未导出 → json 包无法设置     clientId    string `json:"clientId"`    // ❌ 同上     redirectUri string `json:"redirectUri"` // ❌ 同上 }

尽管 JSON 字节流 {“code”:”111″,”clientId”:”222″,”redirectUri”:”333″} 完全合法，json.Unmarshal 仍会成功返回 nil 错误（因为语法无误），但目标结构体所有字段均未被填充，最终打印结果为 { }（空结构体）。

✅ 正确写法是将字段名首字母大写，并保持 JSON tag 与原始键名一致：

type GOOGLE_JSON struct {     Code        string `json:"code"`        // ✅ 导出字段     ClientId    string `json:"clientId"`    // ✅     RedirectUri string `json:"redirectUri"` // ✅ }  body := []byte(`{"code":"111","clientId":"222","redirectUri":"333"}`) var googleJson GOOGLE_JSON  err := json.Unmarshal(body, &googleJson) if err != nil {     log.Fatal("JSON 解析失败:", err) } fmt.Printf("%+vn", googleJson) // 输出：{Code:"111" ClientId:"222" RedirectUri:"333"}

⚠️ 注意事项：

• 字段名大小写变更 不改变 JSON tag 的匹配逻辑；tag 始终决定 JSON 键与结构体字段的映射关系；
• 若字段无需导出但需参与 JSON 编解码（极少数场景），可考虑使用自定义 UnmarshalJSON 方法，但通常应优先遵循导出约定；
• 建议结构体命名采用驼峰式（如 GoogleJSON 而非 GOOGLE_JSON），符合 Go 语言规范；
• 使用 json.Marshal 时同样受此规则约束——未导出字段不会出现在输出 JSON 中。

总结：Go 的 JSON 处理严格依赖字段可见性。牢记 “小写 = 私有 = 不可 JSON 访问”，始终确保待编解码字段首字母大写，即可避免绝大多数 Unmarshal 静默失效问题。