Go net/http Transport怎样设置空闲连接上限为什么请求仍频繁新建连接

Go 的 net/http.Transport 设置了空闲连接上限后，仍然频繁新建连接，通常不是参数失效，而是把“空闲池容量”和“并发连接数量”混在了一起。先复用同一个 Transport，再确认响应体已读完并关闭，最后才根据主机数量和突发并发调整 MaxIdleConnsPerHost。

官方地址：https://pkg.go.dev/net/http

先看 Transport 管理的三条边界

MaxIdleConnsPerHost 控制某个主机在请求完成后最多留下多少条空闲连接；零值使用标准库默认值，并不是无限保留。MaxIdleConns 是所有主机的空闲连接总上限，MaxConnsPerHost 则包含拨号中、正在使用和空闲的连接。IdleConnTimeout 只表示空闲多久后回收。

用共享 Transport 保留连接池

连接池属于 Transport 的内部状态。如果在每次调用中重新创建 Client 或 Transport，前一次请求留下的连接就没有机会被下一次调用复用。下面的配置把单主机空闲连接、所有主机总量和空闲回收时间分开表达：

package main

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

var client = &http.Client{
    Transport: &http.Transport{
        // 控制每个主机完成请求后可保留的空闲连接数。
        MaxIdleConnsPerHost: 8,
        // 控制所有主机合计的空闲连接数量。
        MaxIdleConns: 64,
        // 空闲连接超过这个时间没有新请求就回收。
        IdleConnTimeout: 90 * time.Second,
    },
}

func fetch(url string) error {
    resp, err := client.Get(url)
    if err != nil {
        return err
    }
    // 先消费响应体，给 HTTP/1.x 连接进入可复用路径的机会。
    if _, err := io.Copy(io.Discard, resp.Body); err != nil {
        _ = resp.Body.Close()
        return err
    }
    // 关闭响应体，释放本次响应资源并归还连接状态。
    return resp.Body.Close()
}

示例中的 8、64 和 90 秒只是配置示意，不是所有服务的推荐值。单主机突发请求较多时，可以提高 MaxIdleConnsPerHost；同时访问很多主机时，还要用 MaxIdleConns 控制整体资源预算。需要限制并发总连接数时，另看 MaxConnsPerHost。

为什么设置后仍会频繁新建连接

先不要直接把数字调大。以下情况都可能让下一次请求拿不到旧连接：

• Transport 生命周期太短：请求结束时 Transport 一起被丢弃，连接池也随之失去。
• 响应体未关闭或未消费：连接无法正常回到可复用的空闲状态。
• 空闲时间已到：IdleConnTimeout 到期后，下一次请求会重新拨号。
• 连接键不同：代理、协议、目标主机或端口变化，都可能落到不同的池。
• 对端主动关闭或禁用 keep-alive：客户端的空闲上限不能强迫服务端保留连接。

还要注意 HTTP/2：多个请求可能复用一条 HTTP/2 连接，不能用 HTTP/1.1 下“连接条数”的直觉解释所有结果。要知道到底是复用、从空闲池取出，还是等待后新建，可以记录 GotConnInfo：

import (
    "log"
    "net/http/httptrace"
)

trace := &httptrace.ClientTrace{
    GotConn: func(info httptrace.GotConnInfo) {
        // Reused 表示连接曾被使用，WasIdle 表示本次来自空闲池。
        log.Printf("reused=%v idle=%v idle_time=%v", info.Reused, info.WasIdle, info.IdleTime)
    },
}

req = req.WithContext(httptrace.WithClientTrace(req.Context(), trace))
// 仍需检查 Do 的错误，并在成功后关闭 Response.Body。
resp, err := client.Do(req)

配置后的排查顺序

1. 确认多个请求使用同一个 Client 和 Transport。
2. 确认每个成功响应都消费并关闭了 Response.Body。
3. 对照目标主机、代理和协议检查连接池键是否一致。
4. 再比较 MaxIdleConnsPerHost、MaxConnsPerHost 与 IdleConnTimeout 的目标是否匹配。
5. 最后用 GotConnInfo.Reused 和 WasIdle 记录真实复用结果。

常见问题

MaxIdleConnsPerHost 能限制并发请求数吗？

不能。它只约束完成请求后留在空闲池中的连接；并发连接总量应看 MaxConnsPerHost。

为什么响应体关闭了还是没有复用？

继续检查是否复用了 Transport、请求是否命中同一个连接键、空闲超时是否已到，以及服务端是否主动关闭 keep-alive。

MaxIdleConnsPerHost 设置为 0 是否代表无限？

不是。零值使用标准库默认的单主机空闲连接上限；需要明确容量时填写正数。

这类问题的关键不是单独放大一个参数，而是把连接池容量、并发总量和空闲生命周期分开配置，再用 trace 结果确认判断。