应直接用 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 会一直阻塞。生产环境必须显式配置。
立即学习“go语言免费学习笔记（深入）”；
推荐方式是初始化带超时的 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 页面，开头是/code>） - 响应是
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 成为故障放大器。
