JSON反序列化失败主因有四：字段名大小写不匹配需用json tag显式映射；数字默认解析为float64，须类型检查再断言；time.Time需RFC3339格式或自定义UnmarshalJSON；启用DisallowUnknownFields时遇未知字段会报错。
JSON反序列化时字段名不匹配导致解析失败
Go 的 encoding/json 默认按结构体字段的**导出名（首字母大写）**映射 JSON 键，且严格区分大小写。如果 JSON 中是 "user_name"，但结构体字段叫 UserName 且没加 tag，它会去匹配 "UserName" —— 显然失败，对应字段保持零值。
解决方法是显式声明 json tag：
type User struct {
ID int `json:"id"`
UserName string `json:"user_name"`
Email string `json:"email,omitempty"`
}
-
omitempty表示该字段为空值（""、0、nil等）时不参与序列化，但反序列化时不影响接收 - tag 中不能有空格，
`json:"user_name, omitempty"`是错的，逗号后不能有空格 - 若 JSON 键含特殊字符（如
@type），tag 必须完整写出：`json:"@type"`
嵌套对象或数组解析时 panic: interface conversion
常见于用 map[string]interface{} 或 []interface{} 做通用解析后，直接类型断言子字段，比如：
data := map[string]interface{}{}
json.Unmarshal(b, &data)
name := data["name"].(string) // panic! 如果实际是 nil 或 float64
JSON 数字默认被解析为 float64，字符串才是 string，布尔是 bool，null 是 nil —— 没有自动类型推导。
立即学习“go语言免费学习笔记（深入）”；
- 务必先做类型检查：
if s, ok := data["name"].(string); ok { ... } - 更稳妥的做法是定义具体结构体，而非依赖
interface{}；只有在字段动态、不可预知时才用 map + 类型断言 - 解析数组时同理：
if arr, ok := data["items"].([]interface{}); ok { for _, v := range arr { ... } }
时间字段解析失败：invalid character 'T' looking for beginning of value
标准 JSON 不支持 time.Time，直接把 time.Time 字段放进结构体并反序列化 ISO8601 时间字符串（如 "2024-05-20T14:23:12Z"）会报这个错 —— 因为 Go 默认用空结构体解码，不识别时间格式。
必须配合 time.Time 的自定义 JSON 方法或使用第三方库，但最轻量的是加 tag 并确保字段类型为 time.Time，同时导入 "time" 包（它自带了 UnmarshalJSON 实现）：
type Event struct {
CreatedAt time.Time `json:"created_at"`
}
- 前提是 JSON 时间字符串符合 RFC3339（如
"2024-05-20T14:23:12Z"）或 Go 默认支持的几种格式 - 若格式不标准（如
"2024/05/20 14:23"），需自定义类型并实现UnmarshalJSON方法 - 注意：
time.Time序列化时默认输出 RFC3339，不是 Unix 时间戳；要转时间戳得手动处理
忽略未知字段避免反序列化失败
当 JSON 包含结构体中未定义的字段时，默认不会报错，而是静默丢弃 —— 这通常没问题。但如果你启用了 Decoder.DisallowUnknownFields()（例如用于强校验 API 输入），遇到未知字段就会返回 json: unknown field "xxx" 错误。
- 关闭该限制只需不调用它；默认行为就是忽略未知字段
- 若需日志记录未知字段，只能先解析为
map[string]json.RawMessage，再逐个检查 key 是否在预期列表中 - 注意
json.RawMessage是未解析的原始字节，适合延迟解析或透传字段
float64 和时间格式的隐式约束，线上出问题往往就卡在这两个地方。 
