Go HTTP 客户端设置 Timeout 后为何仍需关闭响应体

给 http.Client 设置 Timeout，解决的是“一次请求最多允许占用多久”；拿到 Response 后关闭 resp.Body，解决的是“这条响应流和底层资源何时结束”。两者不是替代关系。即使请求在截止时间内返回，只要 err == nil，调用方仍应负责关闭响应体。

一、Timeout 管的是请求时限，不是 Body 生命周期

我排查这类问题时，第一眼会把代码拆成两个问题：请求什么时候算超时，以及响应体什么时候释放。官方文档对 Client.Timeout 的定义很明确，它覆盖建立连接、重定向和读取响应体；计时器在 Do 返回后仍可能因为继续读取 Response.Body 而触发。

这意味着超时是一个截止边界，不是垃圾回收器。客户端把读取中断后，调用方仍要走自己的错误和关闭路径。只要 resp 非空，就不要因为“已经超时”或“状态码不是 200”而跳过清理。

不管你给 Go 标准库的 HTTP 客户端设置的 Timeout 多短，只要 resp 响应体没有手动关闭，底层 TCP 连接就不会正常释放回连接池，长期运行下来很容易堆积大量无用连接，最终出现文件描述符耗尽的异常。哪怕请求已经超时返回，也依然要保证把响应体关闭。

client := &http.Client{Timeout: 5 * time.Second}
resp, err := client.Do(req)
if err != nil {
	// Timeout 可能来自等待响应头，也可能来自读取 Body 的阶段。
	return fmt.Errorf("request failed: %w", err)
}
defer resp.Body.Close() // 获取到响应后，调用方负责关闭响应流。

if resp.StatusCode = 300 {
	// 非 2xx 仍然有 Body，先按业务需要读取或丢弃，再结束函数。
	return fmt.Errorf("unexpected status: %s", resp.Status)
}

二、Close、读到 EOF 与连接复用是三件事

Response.Body 是一个 io.ReadCloser。Close 表示调用方已经用完这条流；Read 返回 io.EOF 则表示内容已经读完。它们有关联，但不是同一个信号。完全不关闭会让资源生命周期失控；只关闭而没有读完，在 HTTP/1 场景下又可能失去复用这条连接的机会。

所以“正确姿势”要看目标：需要正文时持续读到结束，然后关闭；只需要状态码时至少关闭，是否额外读取取决于响应大小和连接复用收益。不要把“关闭后一定复用”写成绝对规则，Transport、协议版本、服务器响应和剩余内容都会影响结果。

三、只看状态码、读取部分内容时怎么处理

如果响应体很小、下一次请求又希望复用 HTTP/1 连接，可以在关闭前把剩余内容读掉。但这不是无条件的模板：一个服务端流式输出、响应很大，或者对端迟迟不结束时，无界 io.Copy 可能让当前函数继续等待。

func fetchStatus(ctx context.Context, client *http.Client, url string) error {
	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
	if err != nil {
		return err
	}
	resp, err := client.Do(req)
	if err != nil {
		return err
	}
	defer resp.Body.Close() // 无论状态码和读取结果如何，都关闭响应体。

	if resp.ContentLength >= 0 && resp.ContentLength = 300 {
		return fmt.Errorf("status %s", resp.Status)
	}
	return nil
}

四、把超时、错误和关闭顺序固定下来

可复用的判断顺序是：先处理 Do 返回的 err；只有 err == nil 时使用 resp，并立刻安排 Body.Close；随后根据业务决定读取完整正文、读取上限，还是只检查状态。这样不会把非 2xx 当成传输失败，也不会因为提前返回而漏掉关闭。

• 看到 Timeout，先确认它覆盖的是总请求时长，还是你想要的连接、响应头或空闲读取超时；更细的阶段控制可配合 Transport 和请求上下文。
• 看到 resp, err := client.Do，不要在状态码判断之前忘记安排 Close。
• 只读一部分时，问自己是否真的需要 HTTP/1 连接复用；大流量响应里重新建连可能比等待剩余内容更合适。
• 排查连接数上涨时，同时看 Body 是否关闭、是否读完、Transport 是否复用，以及是否存在长时间未结束的流式接口。

相关问题

设置了 Timeout，还需要给请求加 Context 吗？

需要时可以同时使用。Client.Timeout 是客户端级截止时间，请求 Context 可以把取消原因和更细粒度的生命周期传给本次调用；两者谁先到谁先结束请求。

状态码是 404，还要关闭 Body 吗？

要。HTTP 状态码不是传输错误，err == nil 时返回的响应体仍由调用方负责关闭。

只调用 Close 能保证连接复用吗？

不能保证。HTTP/1 通常需要把响应体读到 EOF 才更有利于复用，但是否值得读取取决于响应大小、服务器行为和等待成本。