Go 中 http.Response.Body 必须手动关闭且只能读一次：不调用 Close() 会导致连接无法复用、内存泄漏；Body 是 io.ReadCloser，仅可完整读取一次，重复读取返回 io.EOF；需先 io.ReadAll 再 Close，或用 json.NewDecoder 流式解析；大响应避免 ReadAll，非 JSON 响应需按 Content-Type 选用对应解析方式。
Go 中 http.Response.Body 必须手动关闭且只能读一次
HTTP 响应体 Body 是一个 io.ReadCloser，底层通常为网络连接的缓冲流。不调用 resp.Body.Close() 会导致连接无法复用（keep-alive 失效）、内存泄漏，甚至触发 http: read on closed response body 错误。
更关键的是：它只能被完整读取一次。重复调用 io.ReadAll(resp.Body) 第二次会返回空字节切片和 io.EOF，不是“没数据”，而是流已耗尽。
- 务必在读取完成后立即调用
resp.Body.Close()（推荐用defer resp.Body.Close()，但注意 defer 在函数 return 后才执行，若提前 panic 可能跳过） - 若需多次使用响应数据（比如日志 + 解析），先用
io.ReadAll拷贝到[]byte，再从该切片构造bytes.NewReader - 避免在中间件或封装函数中“偷偷读一次 Body”却不返回，这会让上层代码永远读不到数据
用 json.Unmarshal 解析 JSON 响应前要确保 Body 已完全读取
Go 的 json.Unmarshal 接收 interface{}，不能直接传 resp.Body —— 它需要完整的字节流，而 Body 是流式接口。常见错误是：
err := json.Unmarshal(resp.Body, &v) // ❌ 编译失败：*io.ReadCloser 不是 []byte
正确做法是先读取全部内容，再解析：
立即学习“go语言免费学习笔记（深入）”；
body, err := io.ReadAll(resp.Body)
if err != nil {
return err
}
defer resp.Body.Close() // 注意：Close 必须在 ReadAll 之后，否则可能中断读取
err = json.Unmarshal(body, &v)
- 如果响应很大（如文件下载），不要用
io.ReadAll，改用json.NewDecoder(resp.Body)流式解码，但此时不能再复用 Body 或调用 Close 前读其他内容 -
json.NewDecoder内部会自动处理 UTF-8 BOM 和编码声明，比手动读 +json.Unmarshal更健壮 - 响应 Content-Type 不是
application/json时，json包不会报错，只会静默失败（如字段未填充），建议先检查resp.Header.Get("Content-Type")
处理非 JSON 响应：XML、纯文本、表单数据的读取差异
不同 Content-Type 决定你该用什么方式读取和解析：
-
text/plain或无结构文本：用io.ReadAll+string()转换，或bufio.Scanner行读取（适合大日志流） -
application/xml：用xml.Unmarshal(body, &v)，和 JSON 类似；也可用xml.NewDecoder(resp.Body)流式解析 -
application/x-www-form-urlencoded：用url.ParseQuery(string(body))，返回url.Values（本质是map[string][]string） -
multipart/form-data：必须用resp.MultipartReader()，不能直接读 Body，否则边界解析会错乱
注意：resp.Header.Get("Content-Type") 返回值可能带参数，如 text/html; charset=utf-8，需用 mime.ParseMediaType 提取主类型。
超时与上下文控制下，Body 读取可能被中断
当请求上下文超时（如 ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)），即使 http.Do 返回了 *http.Response，其 Body 也可能处于“半关闭”状态。此时调用 io.ReadAll 会立即返回 context.DeadlineExceeded 错误，且 Body 不可再用。
- 不要假设
resp != nil就代表 Body 可安全读取；始终检查err是否为nil，再处理 Body - 若需强制读完 Body（例如为了释放连接），可用
io.Copy(io.Discard, resp.Body)，它对上下文取消更鲁棒 - 在重试逻辑中，不要复用已读过的
resp.Body；每次重试都是新请求，新 Body
最易被忽略的一点：标准库的 http.Client 默认启用连接池和 keep-alive，但若 Body 没读完或没 Close，该连接会被标记为“不可复用”，后续请求会新建连接——在高并发场景下，这会迅速打满文件描述符。
