Go 的 encoding/json 包可靠但需规范使用：1. 字段名用 json tag 显式绑定 snake_case；2. 空值用 *T 或 sql.NullT；3. 嵌套结构与切片类型须严格匹配；4. 解析前校验 HTTP 状态码。
Go 的 encoding/json 包足够可靠，但直接 json.Unmarshal 原始响应体常导致 panic 或字段丢失——根本原因不是 API 不规范，而是没处理好类型映射和空值边界。
JSON 字段名大小写与 struct tag 不匹配导致字段为零值
API 返回的字段通常是 snake_case（如 user_id），而 Go struct 默认只识别首字母大写的导出字段，且默认按字段名原样匹配。不显式声明 tag 就会完全忽略这些字段。
- 必须用
json:"user_id"显式绑定，即使字段名是UserID - 加
omitempty仅影响序列化，反序列化时不影响；但漏掉它可能导致空字符串/零值覆盖业务默认值 - 如果字段可能为
null（如"age": null），别用int，改用*int或sql.NullInt64类型
嵌套 JSON 对象或数组解析失败，panic: json: cannot unmarshal object/array into Go value
错误通常出现在：把 API 返回的 {"data": {...}} 直接解到 struct{ Data string }，或把 "items": [...] 解到 Items string。类型必须严格对应。
- 先确认响应结构：用
curl -s URL | jq .或打印原始[]byte再决定 struct 层级 - 嵌套对象用内嵌 struct，例如
Data struct{ Name string `json:"name"` } - 数组必须用切片：
Items []Item `json:"items"`，不能是[]Item漏掉字段名 - 若数组元素类型不固定（如混合对象），可先解为
[]map[string]interface{}，再按type字段分支处理
HTTP 响应体未检查 status code 就直接 json.Unmarshal
http.Response.Body 即使返回 404、500，只要 Content-Type 是 application/json，json.Unmarshal 仍会尝试解析——而错误响应体往往是 {"error":"..."}，结构不匹配直接 panic。
立即学习“go语言免费学习笔记（深入）”；
- 务必在
resp.StatusCode >= 200 && resp.StatusCode 后再读取 Body - 更稳妥做法：统一用自定义响应结构体，包含
Error string `json:"error,omitempty"`和Data json.RawMessage `json:"data,omitempty"`，先解析顶层，再按需解析Data - 用
defer resp.Body.Close()防止连接泄漏，尤其在 error 分支里容易遗漏
type APIResponse struct {
Error string `json:"error,omitempty"`
Data json.RawMessage `json:"data,omitempty"`
}
var respBody APIResponse
if err := json.Unmarshal(body, &respBody); err != nil {
return err
}
if respBody.Error != "" {
return fmt.Errorf("API error: %s", respBody.Error)
}
// 此时再解析 respBody.Data 到具体 struct
var user User
if err := json.Unmarshal(respBody.Data, &user); err != nil {
return err
}
最易被忽略的是 HTTP 状态码校验和 json.RawMessage 的分层解析策略——很多问题表面是 JSON 解析失败，实际是服务端返回了错误体，却被当成成功数据硬解。
