http客户端复用HTTP1连接

Go 的 HTTP/1 连接复用，关键不在于每次请求都“手动拿连接”，而在于长期复用同一个 http.Transport，并在每次请求完成后正确关闭 resp.Body。Transport 会缓存可复用连接；如果每次都新建 Client 或 Transport，连接池就无法稳定发挥作用。

下面用标准库写一个适合重复请求的最小结构，重点是共享 Transport、设置合理的空闲容量，以及让响应体走完生命周期。

先把复用关系放在 Transport 上

http.Client 负责更高层的请求调用、重定向和 Cookie 等行为，真正维护底层连接缓存的是 http.Transport。因此，批量请求同一组主机时，应在应用初始化阶段创建一次 Transport 和 Client，而不是在函数内部反复构造。

package main

import (
    "fmt"
    "io"
    "net/http"
    "time"
)

var client = &http.Client{
    Transport: &http.Transport{
        MaxIdleConns:        100,
        MaxIdleConnsPerHost: 10,
        IdleConnTimeout:     90 * time.Second, // 控制空闲连接最长保留时间
    },
}

func fetchStatus(url string) (int, error) {
    resp, err := client.Get(url)
    if err != nil {
        return 0, err // 没有拿到响应时直接返回网络错误
    }
    defer resp.Body.Close() // 关闭响应体，给 Transport 回收连接的机会

    _, err = io.Copy(io.Discard, resp.Body) // 需要丢弃正文时读到末尾
    if err != nil {
        return 0, fmt.Errorf("读取响应体: %w", err)
    }
    return resp.StatusCode, nil
}

示例中的 time.Second 需要同时导入 time；为了突出连接复用，代码把“读取并关闭响应体”放在同一个函数里。只关心状态码时，按当前 Go 文档的建议，仍然应关闭 Body；如果业务还要解析 JSON，就在关闭前完成解码。

响应体不处理完，连接就可能回不到池里

最常见的误区是拿到响应后只读取状态码，忘记关闭 resp.Body。对 Transport 来说，响应体仍是连接上的未完成内容，后续请求未必能安全复用这条 HTTP/1 连接。

排查时按这个顺序看：

• 先看错误分支：只有 err == nil 时才会得到可关闭的响应体。
• 再看关闭位置：拿到响应后尽早 defer resp.Body.Close()，不要把关闭动作藏在永远走不到的分支里。
• 最后看正文策略：需要复用且正文很小，可以读完；正文很大或不需要时，关闭即可，不要为了复用无条件下载巨大内容。

从 Go 1.27 起，Transport 在关闭未读完的 HTTP/1 响应体后，会在有限的时间和字节范围内异步尝试排空；这不是让调用方可以省略 Close，也不意味着大响应一定值得继续下载。稳定写法仍是“需要正文就读取，不需要就关闭”。

用三个参数控制空闲连接池

连接复用不是连接越多越好。可以先按单个上游主机的并发量估算，再调整以下参数：

如果应用准备退出或要主动收缩连接，可以调用 transport.CloseIdleConnections()。它只处理当前空闲连接，不会打断正在使用的连接；不要把它放在每次请求后，否则等于主动破坏复用收益。

连接数上涨时的检查清单

看到 TCP 连接数量持续上涨时，不要先把 DisableKeepAlives 设成 true。这个字段会关闭 keep-alive，让每个连接只服务一次请求，通常会掩盖而不是解决问题。

1. 确认所有请求都共用同一个 http.Client 或同一个 Transport。
2. 确认成功响应的 Body 一定关闭，解析正文的路径也不能漏掉关闭。
3. 确认请求是否实际访问了同一个 scheme、主机和端口；不同地址不会共享同一主机池。
4. 再根据并发量调整 MaxIdleConnsPerHost 与 MaxConnsPerHost，而不是盲目增大。
5. 只有在明确需要断开空闲连接时，才调用 CloseIdleConnections。

一句话总结：复用 HTTP/1 连接的最小闭环是“长期复用 Transport、正确结束 Response.Body、按主机设置容量和空闲时间”。

常见问题

只调用 resp.Body.Close()，还需要读完正文吗？

不需要为了复用而无条件读完；是否读取取决于业务。需要正文就正常读取，不需要正文就及时关闭。Transport 会对部分未读响应体尝试有限排空，但 Close 仍是调用方责任。

每个请求创建一个 Client 会发生什么？

如果同时创建了新的 Transport，就会失去原连接池的长期复用。把 Client 和 Transport 提升到长生命周期对象，通常更符合标准库的设计。

参考资料

Go 官方 net/http 文档：https://pkg.go.dev/net/http

Go 官方 Transport 源码：https://go.dev/src/net/http/transport.go

Go 官方博客：https://go.dev/blog/http-connection-reuse