当前位置：首页 > 文章列表 > Golang > Go教程 > http客户端复用HTTP1连接

http客户端复用HTTP1连接

来源：17golang原创 2026-11-15 03:14:42 0浏览收藏

Go 的 HTTP/1 连接复用，关键不在于每次请求都“手动拿连接”，而在于长期复用同一个 http.Transport，并在每次请求完成后正确关闭 resp.Body。Transport 会缓存可复用连接；如果每次都新建 Client 或 Transport，连接池就无法稳定发挥作用。

下面用标准库写一个适合重复请求的最小结构，重点是共享 Transport、设置合理的空闲容量，以及让响应体走完生命周期。

先把复用关系放在 Transport 上

http.Client 负责更高层的请求调用、重定向和 Cookie 等行为，真正维护底层连接缓存的是 http.Transport。因此，批量请求同一组主机时，应在应用初始化阶段创建一次 Transport 和 Client，而不是在函数内部反复构造。

http.Client、Transport、响应体和 HTTP1 空闲连接池的静态关系说明图 — 图1：结构说明图，展示 http.Client、Transport 与 HTTP/1 空闲连接池的复用边界，不是运行截图。

package main

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

var client = &http.Client{
    Transport: &http.Transport{
        MaxIdleConns:        100,
        MaxIdleConnsPerHost: 10,
        IdleConnTimeout:     90 * time.Second, // 控制空闲连接最长保留时间
    },
}

func fetchStatus(url string) (int, error) {
    resp, err := client.Get(url)
    if err != nil {
        return 0, err // 没有拿到响应时直接返回网络错误
    }
    defer resp.Body.Close() // 关闭响应体，给 Transport 回收连接的机会

    _, err = io.Copy(io.Discard, resp.Body) // 需要丢弃正文时读到末尾
    if err != nil {
        return 0, fmt.Errorf("读取响应体: %w", err)
    }
    return resp.StatusCode, nil
}

示例中的 time.Second 需要同时导入 time；为了突出连接复用，代码把“读取并关闭响应体”放在同一个函数里。只关心状态码时，按当前 Go 文档的建议，仍然应关闭 Body；如果业务还要解析 JSON，就在关闭前完成解码。

响应体不处理完，连接就可能回不到池里

最常见的误区是拿到响应后只读取状态码，忘记关闭 resp.Body。对 Transport 来说，响应体仍是连接上的未完成内容，后续请求未必能安全复用这条 HTTP/1 连接。

排查时按这个顺序看：

先看错误分支：只有 err == nil 时才会得到可关闭的响应体。
再看关闭位置：拿到响应后尽早 defer resp.Body.Close()，不要把关闭动作藏在永远走不到的分支里。
最后看正文策略：需要复用且正文很小，可以读完；正文很大或不需要时，关闭即可，不要为了复用无条件下载巨大内容。

从 Go 1.27 起，Transport 在关闭未读完的 HTTP/1 响应体后，会在有限的时间和字节范围内异步尝试排空；这不是让调用方可以省略 Close，也不意味着大响应一定值得继续下载。稳定写法仍是“需要正文就读取，不需要就关闭”。

用三个参数控制空闲连接池

连接复用不是连接越多越好。可以先按单个上游主机的并发量估算，再调整以下参数：

MaxIdleConnsPerHost、MaxConnsPerHost 和 IdleConnTimeout 的静态配置关系图 — 图2：配置边界说明图，展示连接容量、空闲时长和主动收缩之间的关系，不是性能测试结果。

参数	作用	常见判断
`MaxIdleConnsPerHost`	限制每个主机保留的空闲连接数	重复访问同一上游时优先关注
`MaxConnsPerHost`	限制该主机的活动、拨号和空闲连接总数	设置后，超出上限的拨号会等待
`IdleConnTimeout`	限制空闲 keep-alive 连接的保留时长	要和上游或负载均衡器的空闲策略协调

如果应用准备退出或要主动收缩连接，可以调用 transport.CloseIdleConnections()。它只处理当前空闲连接，不会打断正在使用的连接；不要把它放在每次请求后，否则等于主动破坏复用收益。