Go / 系统课时

正确消费响应体

正确消费响应体

调用下游 HTTP 服务时,请求成功返回 *http.Response 并不代表资源已经处理完。你需要按状态码决定读取还是丢弃响应体,并在完成后关闭 Body;否则连接可能无法复用,长时间运行的服务还可能积累连接和相关资源。

学习目标

  • 按状态码选择读取、限量读取或丢弃响应体
  • 正确关闭 Response.Body,理解它与连接复用的关系
  • 识别“大响应体直接丢弃”带来的流量与内存风险

响应体为什么必须处理

http.Client.Do 返回后,响应头已经可用,但响应体仍通过 resp.Body 持续读取。对 HTTP/1.x 来说,Transport 通常只有在前一个响应体被读取到 EOF 并关闭后,才有机会把该连接安全放回空闲连接池;只调用 Close 而没有消费完数据,可能放弃这次复用机会。

对 HTTP/2,多个请求可以共享一条连接,但响应体仍必须及时关闭。长期不读也不关会占用流控窗口、内存和请求相关资源,因此“拿到响应就忘记 Body”在任何协议版本下都不是安全做法。

响应体消费与连接复用流程

按状态码消费 Body

下面的示例使用 httptest.Server 构造本地上游,并用 httptrace 观察连接是否复用。成功响应完整读取;错误响应只保留前 256 字节用于诊断,再把剩余的小型响应体丢弃到 EOF,最后统一关闭。

go
package main

import (
	"context"
	"fmt"
	"io"
	"net/http"
	"net/http/httptest"
	"net/http/httptrace"
)

func fetch(client *http.Client, url string) error {
	req, err := http.NewRequestWithContext(context.Background(), http.MethodGet, url, nil)
	if err != nil {
		return err
	}

	trace := &httptrace.ClientTrace{
		GotConn: func(info httptrace.GotConnInfo) {
			fmt.Printf("got conn: reused=%v\n", info.Reused)
		},
	}
	req = req.WithContext(httptrace.WithClientTrace(req.Context(), trace))

	resp, err := client.Do(req)
	if err != nil {
		return err
	}
	defer resp.Body.Close()

	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
		// 只保留有限错误详情,避免把未知大小的错误页全部读入内存。
		preview, err := io.ReadAll(io.LimitReader(resp.Body, 256))
		if err != nil {
			return err
		}
		// 此处上游响应很小,因此安全地读到 EOF,保留连接复用机会。
		if _, err := io.Copy(io.Discard, resp.Body); err != nil {
			return err
		}
		return fmt.Errorf("unexpected status %d: %q", resp.StatusCode, preview)
	}

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return err
	}
	fmt.Printf("status=%d body=%q\n", resp.StatusCode, body)
	return nil
}

func main() {
	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		if r.URL.Path == "/fail" {
			http.Error(w, "upstream unavailable", http.StatusBadGateway)
			return
		}
		fmt.Fprint(w, "ok")
	}))
	defer server.Close()

	client := &http.Client{}
	_ = fetch(client, server.URL+"/ok")
	if err := fetch(client, server.URL+"/fail"); err != nil {
		fmt.Println("error:", err)
	}
}

预期输出

text
got conn: reused=false
status=200 body="ok"
got conn: reused=true
error: unexpected status 502: "upstream unavailable\n"

第二次请求出现 reused=true,说明第一次响应体被完整消费并关闭后,连接进入了可复用状态。实际网络环境中的连接是否最终复用,还会受到服务端 Connection: close、空闲超时、协议协商和网络错误等因素影响。

读取、丢弃与关闭的边界

业务需要响应内容时,用 io.ReadAll 只适合明确受控的小响应;对可能很大的正文,应使用流式解码器或 io.LimitReader 限制读取量。错误响应也不要为了“强行复用连接”而无上限地 drain,否则可能把一个超大错误页完整下载下来。

如果你确认剩余响应很小,可以 io.Copy(io.Discard, resp.Body) 读到 EOF 后再关闭,以提高 HTTP/1.x 连接复用概率。若响应大小不可控或已经超出业务限额,应优先及时 Close 并接受该连接可能不能复用,而不是为了连接池牺牲资源上限。

处理下游响应时,真正的完成条件不是“已经拿到状态码”,而是“需要的数据已按上限读取或明确放弃,并且 Body 已关闭”。把这一步固定进客户端封装,才能让连接复用和资源占用长期保持可控。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

正确消费响应体

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通