Golang解析JSON网络数据方法

应直接用 json.NewDecoder(resp.Body) 解析HTTP响应，避免先读取为字节切片再json.Unmarshal；需配置http.Client超时、确保结构体字段导出并正确使用json tag；解码前校验状态码和Content-Type。

直接用 json.NewDecoder 解析 HTTP 响应体，别先读成字符串再解码

很多新手会先调用 resp.Body.Read 或 ioutil.ReadAll（Go 1.16+ 改用 io.ReadAll）把响应转成 []byte，再传给 json.Unmarshal。这不仅多一次内存拷贝，还可能因未关闭 Body 导致连接复用失败或内存泄漏。

正确做法是把 resp.Body 直接交给 json.NewDecoder：

resp, err := http.Get("https://api.example.com/data")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close() // 必须 defer，否则连接无法复用
var data map[string]interface{}
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
log.Fatal(err)
}

注意：json.NewDecoder 内部按需读取、流式解析，适合大响应；而 json.Unmarshal 要求整个 JSON 已在内存中。

http.Client 要设超时，否则默认无超时，请求可能永久挂起

Go 的 http.DefaultClient 和零值 http.Client 都没有设置超时，遇到网络卡顿、服务无响应时，Do 会一直阻塞。生产环境必须显式配置。

推荐方式是初始化带超时的 client：

client := &http.Client{
    Timeout: 10 * time.Second,
}

更精细的控制可分别设各阶段超时：

• Transport.DialContext 控制建连超时
• Transport.ResponseHeaderTimeout 控制收到 header 的时限
• Transport.TLSHandshakeTimeout 控制 TLS 握手时间

若只设 Client.Timeout，它覆盖的是从发起请求到读完响应体的总时间，对调试定位具体卡点帮助有限。

结构体字段必须导出 + 正确加 json tag，否则解析为零值

JSON 解码只能赋值到导出字段（首字母大写），且默认按字段名匹配。API 返回字段名是 user_name，但结构体写成 UserName 就会失败——除非加 tag 显式映射：

type User struct {
    ID       int    `json:"id"`
    UserName string `json:"user_name"` // 必须这样，否则解不出
    Email    string `json:"email,omitempty"` // omitempty 表示空值不参与编码，解码不影响
}

常见错误：

• 字段小写（如 userName）→ 解码跳过，保持零值
• tag 拼错（如 json:"user_name " 多了个空格）→ 匹配失败
• 忘记导出，结构体定义在包外不可见 → 解码器根本看不到该字段

用 json:",string" 可以把数字字符串（如 "123"）自动转成 int，但仅限基本类型，慎用于嵌套结构。

遇到 invalid character 'N' looking for beginning of value 错误，先检查响应状态和 Content-Type

这个错误不是 JSON 格式问题，而是解码器读到了非 JSON 内容，比如：

• resp.StatusCode != 200，服务返回了 HTML 错误页（如 Nginx 502 页面，开头是 ）
• 响应是 text/plain 或 text/html，但代码仍强行用 json.Decoder
• API 返回了重定向（302），但没设置 Client.CheckRedirect，导致自动跳转后解码跳转响应体

安全做法是解码前校验：

if resp.StatusCode < 200 || resp.StatusCode >= 300 {
    body, _ := io.ReadAll(resp.Body)
    log.Printf("HTTP %d: %s", resp.StatusCode, string(body))
    return
}
if ct := resp.Header.Get("Content-Type"); !strings.HasPrefix(ct, "application/json") {
    log.Printf("unexpected Content-Type: %s", ct)
    return
}

有些 API 在错误时仍返回 200 状态码但响应是 error JSON（如 {"error":"not found"}），这时需要统一响应结构体或手动判断字段是否存在。

解析 JSON 网络数据的关键不在“怎么解”，而在“怎么拿到干净、可信、及时终止的响应流”。client 配置、错误分支处理、结构体定义规范，三者缺一都会让 json.Decode 成为故障放大器。