Go HTTP/2 连接池与复用实战：Transport 调优、Keep-Alive、连接泄漏排查

// 很多人只配置了 Client，却忘了最关键的 Transport
client := &http.Client{
    Timeout: 10 * time.Second,        // 整个请求总超时
    Transport: &http.Transport{
        // —— 连接池三剑客 ——
        MaxIdleConnsPerHost: 100,     // 每个 host 可保留的空闲连接数
        MaxConnsPerHost:     200,     // 每个 host 的连接总数上限
        IdleConnTimeout:     90 * time.Second, // 空闲连接回收时间
        // —— 绕过代理直连 ——
        Proxy: http.ProxyFromEnvironment,
        // —— 建立连接超时 ——
        DialContext: (&net.Dialer{
            Timeout:   5 * time.Second,   // 建立 TCP 连接超时
            KeepAlive: 30 * time.Second,  // TCP keepalive
        }).DialContext,
        TLSHandshakeTimeout: 5 * time.Second, // TLS 握手超时
        ResponseHeaderTimeout: 5 * time.Second, // 等待响应头超时
    },
}

复用流程（第二次请求）：
  1. 从池取出空闲连接
  2. Reuse = true，不做三次握手 & TLS
  3. 请求完成后归还池中，等待下次复用
  4. 若 IdleConnTimeout 到期，连接被关闭回收

不复用的情况：
  - 每次 url 不同 host（PerHost 上限）
  - 请求显式 Connection: close
  - 连接被服务端超时关闭

// ❌ 忘了 body，连接池无法复用，连接泄漏
resp, err := http.Get("https://api.example.com")
defer resp.Body.Close()   // ← 必须关闭，否则连接不归还池

// ✅ 正确的读与关闭
resp, err := http.Get(url)
if err != nil { /* 处理 */ }
defer resp.Body.Close()
// 即使不用 body，也要 drain 再关，让连接可复用
_, _ = io.Copy(io.Discard, resp.Body)

// Go 的 net/http 默认会缓存 DNS 解析结果（Dialer 的 Resolver）
// 关键：resolver 缓存存活时间（LookupHost 结果缓存 30s 左右）
// 频繁变动的域名（故障转移/多活）要关掉缓存：
transport := &http.Transport{
    DialContext: (&net.Dialer{
        Resolver: &net.Resolver{
            PreferGo: true,          // 用 Go 自己的解析器
        },
        // 每次 Dial 强制重新解析：
        // 也可配置 resolver 不缓存
    }).DialContext,
}

DNS 缓存要点：
  - 默认有缓存 → 域名切换后旧 IP 仍被复用一段时间
  - 需要即时故障转移时关闭缓存或缩短 TTL
  - 连接池是建立在"域名 → IP"之上的，缓存过期会重建连接

// 全局共用一个 Transport（连接池共享，而不是每个请求新建）
var httpClient = &http.Client{
    Transport: sharedTransport(),
}

func sharedTransport() *http.Transport {
    transport := http.DefaultTransport.(*http.Transport).Clone()
    transport.MaxIdleConnsPerHost = 100
    transport.IdleConnTimeout = 90 * time.Second
    return transport
}

// 别再：
// for { resp, _ := &http.Client{}.Get(...) }  // 每个都新建池

// 三层超时，层层兜底
// 1. DialContext → 建立 TCP 连接超时
// 2. TLSHandshakeTimeout → TLS 握手超时
// 3. ResponseHeaderTimeout → 等响应超时
// 4. Client.Timeout → 整个请求总超时
client.Timeout = 10 * time.Second

□ 永远 defer resp.Body.Close()，读完才分批连接
□ 用全局共享 Transport，别每个 goroutine 都建 Client
□ 有 HTTP/2（h2c/h2）时连接复用更高效（多路复用）
□ 关闭 KeepAlive 只在流量极低时考虑
□ 用监控看 TIME_WAIT 与连接数，反映池健康
□ 注意代理与连接池的相互作用，别让代理绕过复用
□ 网关类服务把 MaxIdleConnsPerHost 调到几百