Golang如何使用encoding/json进行JSON解析_Golang JSON序列化与反序列化

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 是未解析的原始字节，适合延迟解析或透传字段

字段命名、类型断言、时间格式、未知字段处理——这四点覆盖了 90% 的实际解析问题。最容易被忽略的是数字默认为 float64 和时间格式的隐式约束，线上出问题往往就卡在这两个地方。