需显式用json:”xxx”标签匹配字段名，动态key用map[String]interface{}或json.rawmessage，可选字段用指针类型，模糊类型用json.rawmessage二次解析，大json用json.newdecoder流式处理，自定义序列化实现marshaljson方法。
JSON反序列化时字段名不匹配怎么办
go 的 json.Unmarshal 默认按结构体字段的公开性（首字母大写）和标签（json:"xxx"）映射，小写字段或命名不一致会直接忽略。常见现象是解析后字段全为零值，但又没报错。
- 必须用
json:"field_name"显式声明键名，尤其当 JSON 键含下划线（如user_id）而 Go 字段习惯驼峰（UserID）时 - 如果 JSON 键不确定（比如动态 key），别硬套结构体，改用
map[string]Interface{}或json.RawMessage - 嵌套对象字段若未加
json标签且类型不匹配（比如 JSON 传字符串，Go 字段是int），会静默失败——建议开启严格模式：用json.Decoder并调用DisallowUnknownFields()
如何安全解析可能缺失或类型不固定的字段
真实 API 返回常有可选字段、空字符串代替 NULL、数字/字符串混用（如 "count": 5 和 "count": "5"）。直接定义为 int 或 string 会 panic。
- 对可能为空的字段，用指针类型（如
*string、*int64），反序列化后判空即可 - 对类型模糊字段（如
value可能是数字或字符串），定义为json.RawMessage，后续按需用json.Unmarshal二次解析 - 避免用
interface{}做顶层解析——它会导致大量类型断言和运行时 panic，优先收口为具体结构体 + 合理默认值
处理大 JSON 或流式响应时内存暴涨
用 json.Unmarshal 一次性加载整个字节切片到内存，遇到几 MB 以上的 JSON 容易 OOM，尤其在 http handler 中反复调用。
- 对接 streaming response（如 SSE、长 JSON 数组），用
json.NewDecoder(resp.Body)配合Decode()循环读取，每次只解析一个对象 - 解析大型数组时，别用
[]MyStruct—— 改为逐个Decode到单个变量，处理完即丢弃 - 注意
http.Response.Body必须被完整读取或显式关闭，否则连接无法复用；json.NewDecoder不会自动关 body
自定义 JSON 序列化逻辑（比如时间格式、敏感字段过滤）
标准 time.Time 序列化为 RFC3339，但 API 常要秒级时间戳或自定义格式；密码、Token 等字段也不该被意外输出。
立即学习“go语言免费学习笔记（深入）”；
- 实现
MarshalJSON()方法：例如让Time输出为int64时间戳，而非字符串 - 敏感字段加
json:"-"标签可彻底排除；或用json:"field,omitempty"结合字段零值控制是否输出 - 若需全局统一时间格式，别改所有字段类型，而是封装一个带自定义
MarshalJSON的type timestamp int64
实际项目里最常被忽略的是错误处理粒度——json.Unmarshal 返回的 Error 只告诉你“解析失败”，但不指出哪一行、哪个 key 出问题。真要 debug，得配合 json.SyntaxError.Offset 手动定位，或者换用更透明的库如 go-json。