Golang如何解析HTTP响应数据_HTTP响应读取流程

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

正确做法是先读取全部内容，再解析：

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，该连接会被标记为“不可复用”，后续请求会新建连接——在高并发场景下，这会迅速打满文件描述符。