Go context HTTP 超时 关闭响应体并复用连接

Go 里控制 HTTP 超时，不能只在外层等待一个计时器。更稳妥的做法是用 context.WithTimeout 创建请求级生命周期，把它绑定到 http.Request；请求成功拿到响应后，无论状态码是不是 2xx，都及时关闭 resp.Body。循环调用时还要复用同一个 http.Client，否则 Transport 很难发挥持久连接复用的价值。

官方资料说明，外发请求的 Context 会影响建立连接、发送请求、接收响应头以及读取响应体；Client.Do 成功返回时，Response.Body 非空且由调用方负责关闭。

结论：每次请求用 WithTimeout 限制全链路，使用 NewRequestWithContext 绑定上下文，成功拿到响应后关闭 Body，批量请求则复用同一个 http.Client。

先把超时放在请求生命周期里

http.Client.Timeout 可以提供客户端级的总超时，而 context.WithTimeout 更适合表达某一次调用的截止时间。这样同一个 Client 可以服务不同接口：短接口使用短 deadline，上传或大响应接口使用更长 deadline。

下面的结构图只表达对象和调用关系，是静态说明图，不是运行截图。关键关系是：业务调用持有 ctx，Request 绑定 ctx，Client 使用 Request，Transport 负责连接和响应。

func fetch(ctx context.Context, client *http.Client, endpoint string) ([]byte, error) {
	// 每次调用创建独立的超时上下文，避免请求无限等待。
	requestCtx, cancel := context.WithTimeout(ctx, 3*time.Second)
	defer cancel() // 请求结束后释放上下文关联的计时器。

	req, err := http.NewRequestWithContext(requestCtx, http.MethodGet, endpoint, nil)
	if err != nil {
		// URL 构造失败时还没有发出请求，直接返回原因。
		return nil, fmt.Errorf("create request: %w", err)
	}

	resp, err := client.Do(req)
	if err != nil {
		// 超时、取消或网络错误都属于传输层失败。
		return nil, fmt.Errorf("send request: %w", err)
	}
	defer resp.Body.Close() // 任何 HTTP 状态码都要关闭响应体。

	if resp.StatusCode = http.StatusMultipleChoices {
		return nil, fmt.Errorf("unexpected status: %s", resp.Status)
	}
	return io.ReadAll(io.LimitReader(resp.Body, 2

为什么响应体必须关闭

Do 返回非 nil 响应时，非 2xx 并不自动变成 Go error。调用方仍然要处理状态码，同时关闭 Body。如果只检查 err 就返回，错误响应体也可能长期占住资源。

对于需要完整读取的小响应，io.ReadAll 后再关闭即可；对于只关心状态或响应很大的接口，可以用 io.LimitReader 设上限，但不要把“限制读取”当成“可以不关闭”。关闭动作仍然是响应生命周期的一部分。

复用 Client，才能给 Transport 留出复用连接的机会

默认 Transport 会按需建立网络连接，并缓存连接供后续调用使用。工程代码应在服务初始化时创建一个 Client，在多次请求之间共享它；不要在每次函数调用里都写 &http.Client{}。

type API struct {
	// Client 在 API 实例生命周期内复用，Transport 才能维护连接缓存。
	client *http.Client
}

func NewAPI() *API {
	return &API{
		// 总超时是兜底边界；具体请求仍可用 context 设置更细的期限。
		client: &http.Client{Timeout: 8 * time.Second},
	}
}

func (a *API) Get(ctx context.Context, endpoint string) error {
	// fetch 会绑定请求级 context，并负责关闭 Response.Body。
	_, err := fetch(ctx, a.client, endpoint)
	return err
}

超时、读取失败和状态码要分开判断

超时可能发生在建连、发送、等待响应头或读取响应体的不同阶段。代码不应把所有错误都转成“接口返回错误”；可以用 errors.Is(err, context.DeadlineExceeded) 判断上下文期限，网络错误则保留原始错误链。另一方面，拿到响应后的 404、429 或 500 是 HTTP 状态，不等同于 client.Do 的传输错误。

一个实用的处理顺序是：先判断 Do 是否返回错误，再立即安排 Body.Close，然后判断状态码，最后按响应大小读取内容。这样每个资源和错误分支都有明确归属。

相关问题

只设置 http.Client.Timeout 还需要 context 吗？需要时仍建议使用。Client 超时适合作为统一兜底，context 更适合由调用方传递取消信号和本次请求的独立期限。

收到 500 时也要关闭 Body 吗？要。只要 Do 成功返回响应，就应关闭 resp.Body，无论状态码是否为 2xx。

关闭 Body 就一定复用连接吗？不保证每次都复用，但完整读取并关闭能让 Transport 获得复用持久连接的机会；是否复用还取决于协议、服务端响应和 Transport 配置。