你是否遇到过这样的场景：Go程序刚上线时运行流畅，但随着并发量增加，逐渐变得卡顿，甚至出现"too many open files"错误？这很可能是因为没有正确配置HTTP连接池，结合我实际项目中的经历探讨一下Go语言中net/http的连接池。

为什么需要连接池？

在网络通信中，TCP连接的建立是一个昂贵操作——需要三次握手。如果每次HTTP请求都创建新连接，高并发场景下会消耗大量资源。

Go的标准库net/http其实已经内置了连接池机制。当你使用http.Client发送请求时，它会自动复用底层TCP连接。但默认配置在高并发环境下往往不够用，需要我们进行适当调整。

核心配置参数

1. MaxIdleConnsPerHost（每主机最大空闲连接数）

这是最关键的性能参数，默认值只有2，在高并发环境下明显不足。

transport := &http.Transport{
    MaxIdleConnsPerHost: 20, // 建议设置为并发数的1/3到1/2
}

有项目通过将此值从2提高到50，QPS提升了整整3倍。

2. MaxIdleConns（全局最大空闲连接数）

控制整个客户端允许的最大空闲连接数（不区分主机）。

transport := &http.Transport{
    MaxIdleConns: 100, // 通常设置为MaxIdleConnsPerHost * 预期服务数量
}

3. IdleConnTimeout（空闲连接超时时间）

控制空闲连接在连接池中的存活时间。

transport := &http.Transport{
    IdleConnTimeout: 90 * time.Second,
}

4. MaxConnsPerHost（每主机最大连接数）

限制对单个主机的总连接数（包括活跃+空闲），防止连接数无限增长。

transport := &http.Transport{
    MaxConnsPerHost: 50, // 设置为峰值并发数
}

完整配置示例

下面是一个生产环境推荐的HTTP客户端配置：

func createProductionClient() *http.Client {
    transport := &http.Transport{
        // 连接池配置
        MaxIdleConns:        100,
        MaxIdleConnsPerHost: 25,    // 并发请求数的1/3到1/2
        MaxConnsPerHost:     50,    // 峰值并发数
        IdleConnTimeout:     90 * time.Second,

        // 超时配置
        DialContext: (&net.Dialer{
            Timeout:   5 * time.Second,  // 建立TCP连接超时
            KeepAlive: 30 * time.Second, // TCP保活周期
        }).DialContext,
        TLSHandshakeTimeout:  5 * time.Second,   // TLS握手超时
        ResponseHeaderTimeout: 10 * time.Second, // 读取响应头超时
    }

    return &http.Client{
        Transport: transport,
        Timeout:   30 * time.Second, // 整体请求超时
    }
}

超时控制：分层超时策略

没有超时控制的HTTP请求就像放出去的风筝，可能永远不会回来。建议设置分层超时：

client := &http.Client{
    Timeout: 5 * time.Second, // 整体超时时间
    Transport: &http.Transport{
        ResponseHeaderTimeout: 2 * time.Second, // 读取响应头超时
        DialContext: (&net.Dialer{
            Timeout: 1 * time.Second, // 建立TCP连接超时
        }).DialContext,
    },
}

某支付系统通过增加分级超时控制，将接口成功率从99.5%提升到了99.9%。

常见陷阱与解决方案

1. 连接泄漏

问题：未关闭响应体会导致连接无法复用，最终文件描述符耗尽。

解决方案：始终使用defer关闭响应体，并读取剩余数据

resp, err := client.Get(url)
if err != nil {
    return err
}
defer func() {
    if resp.Body != nil {
        io.Copy(io.Discard, resp.Body) // 读取剩余数据
        resp.Body.Close() // 关闭Body
    }
}()

2. 默认配置不足

问题：http.DefaultClient没有超时设置且连接池配置保守。

解决方案：始终为生产环境创建自定义Client

// 不要使用默认客户端进行生产请求
// client := http.DefaultClient // 错误方式

// 应该创建自定义客户端
client := &http.Client{
    Timeout: 10 * time.Second,
    Transport: &http.Transport{
        MaxIdleConnsPerHost: 20,
    },
}

3. 不区分场景使用相同配置

问题：对所有请求使用相同配置，无法发挥最优性能。

解决方案：根据场景使用不同配置

配置建议与实战技巧

1. 合理配置连接池参数：根据实际负载测试结果调整关键参数，例如将 MaxIdleConnsPerHost 设置为预期并发数的 1/3 到 1/2，并设置 MaxConnsPerHost 以限制对单一主机的总连接数。IdleConnTimeout 不宜过短或过长（例如 90 秒），以平衡连接复用和资源释放。
2. 始终处理响应体并关闭：必须读取并关闭响应体（resp.Body.Close()），否则连接无法归还到池中复用，会导致连接泄漏。使用 defer 并在关闭前读取剩余数据（如使用 io.Copy(io.Discard, resp.Body)）是好习惯。
3. 复用 http.Client 实例：绝对不要为每个请求创建新的 http.Client。应该在整个应用程序中复用同一个或少量精心配置的客户端实例，这样才能真正利用连接池的优势。
4. 实施分层超时控制：为不同阶段设置超时（如 DialTimeout, TLSHandshakeTimeout, ResponseHeaderTimeout），并结合 context 进行更细粒度的超时控制，防止慢请求拖垮整个应用。

写在最后

Go语言的net/http库提供了强大而灵活的连接池机制，但默认配置不适合高并发场景。通过适当调整MaxIdleConnsPerHost、MaxIdleConns等参数，并结合分层超时策略，可以大幅提升应用程序的性能和稳定性。

记住：不要使用默认客户端进行生产请求，始终根据你的具体需求创建自定义配置。