Go中JSON字段为空主因是结构体字段未导出（首字母小写），导致json.Unmarshal无法赋值；需确保字段首字母大写，或用json:"key"标签绑定，同时必须检查error并正确使用指针类型区分null与零值。
字段为空是因为结构体字段不可导出
Go 的 json.Unmarshal 只能设置导出（首字母大写）字段，如果结构体字段是小写字母开头，反序列化时会被完全忽略，看起来就像“字段为空”。这不是 bug，而是 Go 的反射机制限制。
- 检查结构体字段名是否以大写字母开头，例如
UserName✅，username❌ - 若需保持 JSON 键小写但结构体字段可导出，用 struct tag 显式绑定：
json:"username" - 嵌套结构体同理——所有中间层级字段都必须可导出，否则整层丢失
空字符串、零值、nil 的区别要分清
JSON 中的 null、空对象 {}、空数组 []、空字符串 "" 在 Go 里映射行为不同，容易误判为“字段没解析”。
-
null→ 对应指针字段（如*string）会设为nil；对应非指针字段（如string）会设为零值（""） - 想区分“未提供”和“明确设为 null”，必须用指针类型或
sql.NullString类型 - 空 JSON 对象
{}不会触发嵌套结构体字段的零值覆盖——前提是该字段本身没在 JSON 中出现；但如果 JSON 里写了"user":{}，且User是结构体（非指针），则User字段会被初始化为全零值
struct tag 写错导致字段被跳过
常见拼写错误或遗漏会直接让字段不参与解析，比如大小写不一致、多加空格、用了单引号等。
- 正确写法：
json:"user_id"，不是json:"user_id "（尾部空格）、json:'user_id'（单引号）、json:"UserId"（与 JSON key 不匹配） - 忽略字段用
json:"-"，不是json:"-"（注意引号是英文双引号） - 需要支持多种 key 名（如兼容旧版 API），可用第三方库如
mapstructure，标准库不支持别名
Unmarshal 后字段仍是零值？先检查 error
json.Unmarshal 失败时不会 panic，而是返回 error，但很多人只看结果不看 err，误以为解析成功了。
立即学习“go语言免费学习笔记（深入）”；
- 务必检查
err != nil，常见错误包括：JSON 格式非法、数字超 int64 范围、字段类型不匹配（如把字符串塞进int） - 典型报错：
json: cannot unmarshal string into Go struct field X.Y of type int—— 这时Y字段不会被修改，保持零值 - 调试技巧：先用
json.RawMessage接收原始字节，再打印或验证结构，避免类型强转过早失败
var raw json.RawMessage
err := json.Unmarshal(data, &raw)
if err != nil {
log.Printf("raw parse failed: %v", err)
return
}
log.Printf("raw JSON: %s", raw)
字段映射失效往往不是 JSON 本身的问题，而是结构体定义、tag 声明或类型选择没对齐。最常被忽略的是首字母大小写和 error 检查——这两处一错，其他再精细也没用。 
