17370845950

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。

• 务必在 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 解析失败，实际是服务端返回了错误体，却被当成成功数据硬解。