Go net/http Response.Body 为什么关闭后连接行为变化（参数形态）

在 Go 的 net/http 客户端里，Response.Body 不是一个可以随手忽略的返回字段。它的类型形态是 io.ReadCloser：需要读取时从中取数据，使用结束后由调用方关闭。连接行为之所以会变化，是因为 Transport 是否有机会复用 HTTP/1.x 的持久连接，取决于响应体的消费与关闭方式。

官方文档：https://pkg.go.dev/net/http#Client.Do

最稳妥的默认规则是：请求成功后先安排 defer resp.Body.Close()；如果后续请求希望尽量复用 HTTP/1.x 连接，就在关闭前把需要的响应体读完。只关闭能释放资源，但“释放资源”和“保证连接可复用”不是同一个动作。

Response.Body 的两个职责不要混在一起

Client.Do 返回且错误为 nil 时，响应会带有非空的 Body。它由 HTTP 客户端提供，调用方负责在完成读取后关闭。这里有两个独立职责：读取决定你消费了多少响应内容，关闭决定你是否把底层资源的生命周期交还给客户端。

因此，下面这段最小写法仍然是必要的，即使你只关心状态码：

resp, err := client.Do(req)
if err != nil {
	return err
}
defer resp.Body.Close() // 响应体由调用方负责关闭，避免资源长期占用

// 状态码不是错误返回的替代品；非 2xx 仍可能带有可读取的响应体。
if resp.StatusCode = 300 {
	return fmt.Errorf("unexpected HTTP status: %s", resp.Status)
}

不要把“Close 成功”理解成“连接一定回到空闲池”。关闭动作完成了资源交接，但连接能否继续使用还受到是否读到响应末尾、协议版本、服务器响应以及 Transport 状态的影响。

为什么只 Close 仍可能影响连接复用

Go 官方文档对 Client.Do 的说明很关键：如果响应体没有读到 EOF 并关闭，底层 RoundTripper 可能无法复用持久 TCP 连接；关闭时 Transport 还会在有限范围内尝试异步读完响应体。这个“有限范围”不是业务代码可以当成无限制缓冲来依赖的保证。

所以两种写法的语义不同：

• defer resp.Body.Close()：确保资源在当前函数结束时关闭，适合不需要响应内容或只处理小部分内容的场景。
• 先完整读取，再关闭：让 Transport 更明确地看到响应体已经消费完成，适合后续请求较多、希望保持连接复用的场景。

这里说的是“可能无法复用”，不是“每次都会新建 TCP 连接”。HTTP/2 的复用模型也不同，不能把 HTTP/1.x 的连接池现象机械套到所有协议上。

按响应大小选择读取方式

小响应可以整体读入内存；大响应则应边读边处理，避免为了连接复用把整个文件一次性放进内存。无论采用哪种方式，读取错误和关闭都要保留在同一条资源路径上。

func readSmallResponse(resp *http.Response) ([]byte, error) {
	defer resp.Body.Close() // 无论读取成功还是失败，都要释放响应体

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		return nil, fmt.Errorf("read response body: %w", err)
	}
	return data, nil
}

func drainResponse(resp *http.Response) error {
	defer resp.Body.Close() // 流式消费完成后仍要关闭 Body

	// 丢弃内容但读到末尾，适合只关心状态码且响应体不大的场景。
	if _, err := io.Copy(io.Discard, resp.Body); err != nil {
		return fmt.Errorf("drain response body: %w", err)
	}
	return nil
}

如果响应体可能很大，实际项目通常不是无条件 io.Copy，而是把读取接到文件、解码器或业务流式处理器上。关键不在于把内容丢掉，而在于明确读取策略、限制内存使用，并在返回前关闭 Body。

排查“关闭后连接行为变化”的顺序

1. 先确认 Do 成功后的每个响应路径都安排了 Close，包括状态码异常和提前返回。
2. 再确认是否只读取了头部或固定前缀；如果后面还有大量请求，评估是否应该读到 EOF。
3. 检查是否反复创建新的 http.Client 或 Transport。官方文档建议复用 Client，因为 Transport 会缓存连接。
4. 最后区分 HTTP/1.x 与 HTTP/2，不要只凭“连接数变化”推断 Body.Close 本身出了问题。

如果只是忽略响应内容，关闭仍然不能省略；如果要复用连接，读取策略也不能省略。两者是同一条请求资源管理链上的不同责任。

常见问题

只调用 Close，不读取 Body，可以吗？

可以释放响应体，但不能把它等同于“连接一定可复用”。如果连接复用重要，应该根据响应大小和业务需要读取到 EOF，再关闭。

非 2xx 响应也需要关闭 Body 吗？

需要。非 2xx 通常不会自动变成 Do 的错误返回，响应体仍然需要由调用方关闭；错误分支尤其容易漏掉这一步。

把 Body 交给 json.Decoder 后还要 Close 吗？

要。Decoder 负责从 Body 读取并解析，不能替代 Body 的生命周期管理。解析完成后仍应执行 defer resp.Body.Close()。

小结

Response.Body 的参数形态决定了它同时承担“可读取内容”和“可关闭资源”两层职责。Close 是必做的资源交接；读取到 EOF 则会影响 Transport 判断 HTTP/1.x 连接是否适合复用。小响应可整体读取，大响应应采用流式处理，再统一关闭 Body。技术依据：https://pkg.go.dev/net/http#Client.Do、https://pkg.go.dev/net/http#Response、https://pkg.go.dev/net/http#Transport。