Go net/http Response.Body 关闭时自动读取导致延迟怎么办

如果 Go 1.27 的 HTTP/1 客户端在 Response.Body.Close() 附近出现了短暂延迟，先不要把它理解成“Close 会同步下载完整响应体”。新行为是：关闭未读的 HTTP/1 响应体后，Transport 会在后台用保守上限尝试排空，目标是让连接可以复用；官方实现给出的范围是最多约 256 KB 或 50 ms。真正的处理方式仍然是：不需要正文就及时关闭，需要正文就正常读到结束。

只看状态码或响应头时，用 defer resp.Body.Close() 就够了；不要为了“保证复用”无上限地 io.Copy 整个响应体。若延迟仍然明显，应继续检查 HTTP 版本、响应大小、服务端是否要求关闭连接，以及 Client/Transport 是否被错误地频繁创建。

参考入口：https://go.dev/doc/go1.27

先把 Close、读取和连接复用分成三件事

http.Client.Do 成功后，resp.Body 一定非空，调用方负责在用完后关闭它。读取响应正文是业务动作，关闭响应体是资源生命周期动作，连接是否能留在池里则是 Transport 的复用决策。三者有关联，但不是同一个调用。

例如，接口只返回状态码时，不需要为了复用连接把大响应下载到内存或丢弃到磁盘：

resp, err := client.Do(req)
if err != nil {
    return err
}
// 即使不读取正文，也必须关闭响应体；Go 1.27 的 HTTP/1 Transport 会尝试有限排空。
defer resp.Body.Close()

if resp.StatusCode != http.StatusNoContent {
    // 这里只根据状态码分支，避免把无关的大正文读完。
    return fmt.Errorf("unexpected status: %s", resp.Status)
}
return nil

这段代码表达的是调用方意图：我不消费正文，但我会明确释放 Body。它没有承诺连接一定复用，因为复用还受到协议、响应头、响应体剩余大小和 Transport 状态影响。

Go 1.27 的自动排空到底做了什么

Go 1.27 发布说明明确提到，HTTP/1 的 Response.Body 在关闭时会自动排空未读内容，但有保守限制。官方博客进一步给出的实现边界是：后台最多尝试读取 256 KB，或等待 50 ms；如果服务端返回 Connection: close，继续排空没有连接复用价值，Transport 会跳过这类无效工作。

因此，“关闭时自动读取导致延迟”更准确的理解是：关闭动作触发了一个有限的复用机会，而不是 Go 无条件把整个响应体读完。对小响应，它可能帮助下一次请求复用原连接；对大响应或读取进展很慢的响应，达到上限后仍可能放弃复用并建立新连接。

这项行为只解决 HTTP/1 的响应体边界。HTTP/2 使用流和复用连接，不能套用“先把正文读完才能复用 TCP 连接”的 HTTP/1 经验。也不要把图中的静态关系当成运行截图或实测证据。

只看状态码时，为什么不建议手写无上限排空

过去常见的写法是 io.Copy(io.Discard, resp.Body) 后再关闭。它在响应体很小、明确希望复用 HTTP/1 连接时有意义，但放进通用客户端封装后可能带来新的代价：服务端返回一个很大的错误页或下载内容时，调用方会花时间接收并丢弃它。

func requestOK(client *http.Client, req *http.Request) error {
    resp, err := client.Do(req)
    if err != nil {
        return err
    }
    // defer 保证所有分支都释放 Body；不把成功与失败分支拆成两套关闭逻辑。
    defer resp.Body.Close()

    if resp.StatusCode = 300 {
        // 错误场景只保留状态信息，不为连接复用无上限消费正文。
        return fmt.Errorf("http status %s", resp.Status)
    }
    return nil
}

如果业务确实需要正文，就按业务协议读取并处理错误。例如 JSON 接口应当解码 JSON，而不是为了连接池随意增加一次丢弃式读取；如果只需要截取错误原因，也可以在业务层设置明确的字节上限。关闭始终保留。

出现延迟时，按接口目标做取舍

先确认延迟发生在什么位置：是 Close 返回前，还是下一次请求等待可用连接，抑或服务端本来就慢。然后按下面的决策处理：

尤其要注意 Client 与 Transport 的生命周期。官方文档建议复用 Client，因为 Transport 会缓存连接；如果每次请求都创建新的 Client，即使 Body 关闭得很规范，也没有共享连接池来获得稳定的复用收益。

常见问题

Close 会不会一定等待 50 ms？

不会。50 ms 是自动排空的保守上限，不是每次关闭的固定睡眠时间；能快速读到结束、连接不适合复用或不满足排空条件时，行为都会不同。

为了避免延迟，可以不关闭 Body 吗？

不可以。省略关闭会让响应体和底层连接的生命周期失去明确边界，可能阻碍连接复用并造成资源积累。正确做法是关闭，然后根据真实接口目标调整读取策略和连接池配置。

Go 1.26 及更早版本怎么办？

不要把 Go 1.27 的自动排空边界倒推到旧版本。若必须兼容旧版本，应以对应版本的 net/http 文档和源码为准；业务上仍应坚持“读到需要的内容并关闭 Body”，不要依赖未声明的实现细节。

小结

这类延迟问题的核心不是“Close 要不要调用”，而是“调用方到底需要正文，Transport 又能否复用连接”。Go 1.27 已把 HTTP/1 的有限排空交给 Transport：小范围尝试复用，大响应及时止损。应用代码只需保留清晰的 Body 关闭责任，复用 Client/Transport，并根据 HTTP 版本和响应头判断后续优化方向。