Go Transport MaxIdleConnsPerHost 为零有什么影响

先说结论：在 Go 的 http.Transport 中，MaxIdleConnsPerHost: 0 不是“每个主机不保留空闲连接”，而是使用 http.DefaultMaxIdleConnsPerHost。当前官方文档给出的默认值是 2，所以它仍然允许每个主机保留有限的 HTTP keep-alive 连接。

官方资料：https://pkg.go.dev/net/http#Transport

这个区别很容易在排查“请求后连接没有复用”时被忽略：零值代表“采用默认策略”，不代表“关闭复用”。如果你的目标是明确放宽空闲连接数量，就写一个正整数；如果目标是每次请求都不复用连接，应使用 DisableKeepAlives: true。

先给结论：零值不是零条连接

Transport 的这个字段描述的是“每个主机最多保留多少条空闲 keep-alive 连接”。请求完成后，连接如果还适合复用，就可能进入空闲池；后续请求可以从池中取出它，减少重新拨号、TLS 握手和协议建立的开销。

当字段值为零时，标准库会把它换算成默认值。可以把判断过程理解成下面这条规则：

MaxIdleConnsPerHost == 0
        ↓
使用 DefaultMaxIdleConnsPerHost
        ↓
当前官方文档值为 2

因此，下面两种写法在“采用默认每主机空闲上限”这个意图上等价：

package main

import "net/http"

func main() {
	// 零值表示交给 Transport 使用默认的每主机空闲连接上限。
	transportA := &http.Transport{MaxIdleConnsPerHost: 0}

	// 直接写出当前默认常量，意图更明确；不要把它理解成永久不变的业务配置。
	transportB := &http.Transport{
		MaxIdleConnsPerHost: http.DefaultMaxIdleConnsPerHost,
	}

	_, _ = transportA, transportB
}

如果文章或配置的目标是“关闭连接复用”，这两个写法都不对，因为它们仍然允许空闲连接进入复用流程。

它到底限制哪类连接

要理解影响，先把连接分成三个状态：正在拨号、正在服务请求、请求结束后暂时留在池中。MaxIdleConnsPerHost 只针对第三种，也就是某一个主机的空闲 keep-alive 连接。

例如，有 20 个请求同时访问同一主机时，MaxIdleConnsPerHost: 0 并不会把并发请求强行压成 2 个。它只影响这些请求完成后，最多有多少条连接可以作为空闲连接留在该主机的池里。活跃连接数量和拨号行为要看其他配置以及当时的请求状态。

需要更高复用容量时，显式设置正整数

如果客户端长期访问同一个或少数几个服务端，默认的每主机空闲上限可能偏小。此时可以把目标写成一个明确的正整数，并同时设置全局空闲上限和空闲超时：

package main

import (
	"net/http"
	"time"
)

func newClient() *http.Client {
	transport := &http.Transport{
		// 每个主机最多保留 8 条空闲连接，适合有稳定并发的客户端。
		MaxIdleConnsPerHost: 8,
		// 所有主机合计最多保留 100 条空闲连接，避免主机数量增长后池子失控。
		MaxIdleConns: 100,
		// 空闲连接超过 90 秒没有再次使用时主动关闭。
		IdleConnTimeout: 90 * time.Second,
	}

	// Transport 应长期复用，不能为了每个请求都新建一个连接池。
	return &http.Client{Transport: transport}
}

这里的数字不是通用答案。应该根据目标服务数量、请求间隔、服务端 keep-alive 策略和客户端资源预算来设定。重要的是把“每主机上限”和“所有主机总量”分开思考，避免只提高一个值却被另一个上限卡住。

如果真的不想复用连接，用 DisableKeepAlives

有些特殊场景希望每次请求使用一次性 HTTP 连接，例如临时排查连接复用问题，或对连接生命周期有非常明确的隔离要求。这时应该表达“禁用 keep-alive”，而不是把 MaxIdleConnsPerHost 写成零：

package main

import "net/http"

func newOneShotClient() *http.Client {
	transport := &http.Transport{
		// 禁止 HTTP 请求之间复用连接；这与 TCP 层 keep-alive 不是一回事。
		DisableKeepAlives: true,
	}

	return &http.Client{Transport: transport}
}

禁用后，连接复用带来的握手节省也会消失，通常不应作为高并发客户端的默认配置。若只是想清理已经处于空闲状态的连接，可以考虑复用同一个 Transport，并在合适的生命周期节点调用 CloseIdleConnections，而不是把零值误当成清空命令。

为什么配置后看起来没有生效

1. 每次请求都新建 Transport。 连接池属于 Transport；如果每次调用都创建新实例，就没有稳定的池可以复用。
2. 忘记关闭响应体。 读取完响应后应关闭 resp.Body，否则连接不一定能按预期回到可复用状态。
3. 把空闲上限当成并发上限。 空闲连接是请求结束后的状态，MaxIdleConnsPerHost 不负责限制正在处理的请求数量。
4. 忽略协议差异。 HTTPS 请求可能协商 HTTP/2；HTTP/2 的多路复用模型与 HTTP/1.1 的一请求一连接复用池不同，不能只凭这个字段推断所有连接表现。

package main

import (
	"io"
	"net/http"
)

func fetch(client *http.Client, url string) error {
	resp, err := client.Get(url)
	if err != nil {
		return err
	}
	// 关闭响应体，给 Transport 回收或复用连接的机会。
	defer resp.Body.Close()

	// 示例只关心生命周期，真实业务还应检查状态码并处理读取错误。
	_, err = io.Copy(io.Discard, resp.Body)
	return err
}

最后怎么选

如果你只是没有填写 MaxIdleConnsPerHost，让它保持零值即可，它会采用默认的每主机空闲连接上限。如果需要更高的 HTTP/1.1 连接复用容量，就显式设置一个正整数，并结合 MaxIdleConns 与 IdleConnTimeout 规划总量和生命周期。如果需求是完全不复用 HTTP 连接，则使用 DisableKeepAlives: true。

可以记住这句判断：MaxIdleConnsPerHost=0 是“使用默认上限”，不是“零条空闲连接”；它影响的是空闲池，不是所有并发连接。

常见问题

MaxIdleConnsPerHost 设成 1 会禁止连接复用吗？

不会。它表示每个主机最多保留 1 条空闲 keep-alive 连接，仍然允许复用，只是池容量更小。

MaxIdleConnsPerHost 为零是不是没有限制？

不是。这个字段的零值会使用默认值；“零值表示不设上限”的语义对应某些其他字段，不能直接套用。

只调大 MaxIdleConnsPerHost 就够了吗？

不一定。所有主机的空闲连接还会受到 MaxIdleConns 的合计上限影响，连接还会受 IdleConnTimeout 和服务端策略影响。

怎样表达每个请求都使用新连接？

应在 Transport 上设置 DisableKeepAlives: true，不要用 MaxIdleConnsPerHost: 0 代替。