Go的http.Client默认自带连接池,无需手动实现;关键在合理配置MaxIdleConnsPerHost(默认仅2)、IdleConnTimeout(推荐30–90s)等Transport参数,并确保调用resp.Body.Close()归还连接。

http.Client 连接池别自己造,用对 Transport 就够了
Go 的 http.Client 默认就带连接池,根本不用手写 sync.Pool 或 chan 管理 net.Conn。真正要调的是它底下的 http.Transport —— 你 new 一个 http.Client{} 却不配 Transport,就等于默认启用了但参数极不合理。
常见错误包括:
- 每次请求都
new(http.Client{}),导致每个 client 拥有独立 transport,连接完全无法复用 - 全局改
http.DefaultTransport,结果cloud.google.com/go或go.opentelemetry.io的 HTTP 调用也跟着崩 - 设了
DisableKeepAlives = true还想复用连接,纯属白搭
正确做法是:定义一个全局复用的 *http.Client,显式配置其 Transport,并确保所有请求都走它。
MaxIdleConnsPerHost 是最常配错的参数
这个值控制「每个目标 host(比如 api.pay.example.com)最多缓存几个空闲连接」,不是并发上限,也不是活跃连接数上限。它只管“用完、健康、还想留着下次用”的那部分连接。
立即学习“go语言免费学习笔记(深入)”;
典型症状:
- QPS 上去后大量
net/http: request canceled (Client.Timeout exceeded while awaiting headers) -
TIME_WAIT连接暴涨,ss -s显示连接反复新建
调优建议:
- 固定 host 高频调用(如支付网关),设为预期并发的 1/3~1/2;例如稳定 60 QPS,可设
MaxIdleConnsPerHost = 25 - 如果同时调 50+ 不同域名,必须同步放大
MaxIdleConns(全局总数),否则某几个 host 把池子占满,别的 host 就拿不到空闲连接 - 别设太大(比如 >100):内存浪费 + 失效连接滞留更久(当下游 LB 切 IP 或服务重启后,旧连接还在池里瞎试)
IdleConnTimeout 和 DialTimeout 必须分开设,且不能只靠 Client.Timeout
http.Client.Timeout 是总超时,覆盖建连、重定向、读响应体全过程;但它对连接池内部行为毫无影响。真正决定复用效率的是 Transport 的三个超时:
-
DialTimeout:TCP 建连最大耗时,建议3–5s;设太长会让失败连接卡住整个池 -
TLSHandshakeTimeout:HTTPS 场景下必须单独设,和DialTimeout分开,同样建议 ≤5s -
IdleConnTimeout:空闲连接在池里最多躺多久,建议30–90s;设 5s 会导致刚缓存就过期,复用率归零;设 5m 则可能保留已失效连接太久
漏设 TLSHandshakeTimeout 是 HTTPS 场景下最隐蔽的坑——看起来没报错,但连接复用率极低,因为 TLS 握手超时后连接被丢弃,却不触发 IdleConnTimeout 的清理逻辑。
resp.Body.Close() 不只是习惯,是连接归还的唯一信号
http.Transport 只有在你调了 resp.Body.Close() 后,才把连接放回空闲池。漏掉这句,连接就一直被标记为“正在使用”,哪怕你已经读完响应体。
容易踩的坑:
- 用
io.ReadAll(resp.Body)后忘了Close(),连接永远不归还 - 在
defer resp.Body.Close()前 panic 或 return,defer没执行 - 用
json.NewDecoder(resp.Body).Decode(&v)后没关,一样卡连接
安全写法是:不管中间怎么处理,只要拿到 resp,第一件事就是 defer resp.Body.Close(),哪怕后续逻辑可能 panic。



















