json.Unmarshal返回nil但字段为零值，是因为未导出字段（小写首字母）或json key与Struct tag不匹配导致忽略；缺失字段保持零值是设计行为而非bug。
为什么 json.Unmarshal 返回 nil 但结构体字段仍是零值？
常见现象：调用 json.Unmarshal 没报错，但解析后结构体字段全是 0、"" 或 nil。根本原因通常是字段未导出（首字母小写）或 JSON key 与 struct tag 不匹配。
- go 的
encoding/json只能访问**导出字段**（首字母大写），小写字段会被忽略 - JSON 字段名默认按字段名（驼峰转小写下划线）匹配，但更可靠的是显式用
json:tag 控制映射 - 如果 JSON 中有字段缺失，对应字段保持 Go 初始化零值，不会报错 —— 这是设计行为，不是 bug
type User struct { ID int `json:"id"` Name String `json:"name"` Email string `json:"email,omitempty"` // 空值不序列化，反序列化时缺失则设为 "" age int `json:"age"` // 小写字段，Unmarshal 完全忽略 }如何安全处理可能缺失或类型不一致的 JSON 字段？
线上 JSON 数据常有字段缺失、空字符串代替 NULL、数字混用字符串等。硬解到具体类型容易 panic 或静默失败。
- 对不确定字段，先解到
Interface{}或json.RawMessage，再按需转换 - 用
json.RawMessage延迟解析嵌套结构，避免重复解码开销 - 检查字段是否存在：用
map[string]interface{}解一次，再判断 key 是否在 map 中
var raw map[string]interface{} if err := json.Unmarshal(data, &raw); err != nil { return err } if _, ok := raw["user_id"]; !ok { return fmt.Errorf("missing required field: user_id") } // 后续再把 raw["user_id"] 转成 int 或 string json.Marshal 为什么输出空对象 {} 或乱码？
典型表现：结构体明明有数据，json.Marshal 却返回 {}；或中文变成 Unicode 转义（如 "u4f60u597d"）。
- 字段未导出 → 序列化结果不含该字段，所有字段都不导出就得到
{} - 字段有
json:"-"tag → 显式排除，也会消失 - 中文显示为 uXXXX：这是标准 JSON 行为；如需可读中文，用
json.MarshalIndent并确保终端/环境支持 UTF-8 - 时间字段默认序列化为纳秒整数，不是 RFC3339 字符串 —— 需自定义
MarshalJSON方法
嵌套结构 + 动态 key 怎么写 struct tag？
遇到类似 {"2024-01-01": {"status": "ok"}, "2024-01-02": {"status": "fail"}} 这种以日期为 key 的 JSON，不能靠固定字段名建模。
立即学习“go语言免费学习笔记（深入）”；
- 必须用
map[string]YourStruct类型接收，且 key 类型只能是string、int等可比较类型 - struct tag 对 map 本身无效，只作用于 map 的 value 类型字段
- value 结构体仍需正确导出 + tag，否则内部字段无法解析
type DayReport struct { Status string `json:"status"` } var reports map[string]DayReport json.Unmarshal(data, &reports) // data 是 { "2024-01-01": {"status":"ok"} }字段导出、tag 对齐、延迟解析这三件事，漏掉任一环都可能导致“看起来没报错，其实什么都没解析进去”。