Go / 系统课时
正确消费响应体
正确消费响应体
调用下游 HTTP 服务时,请求成功返回 *http.Response 并不代表资源已经处理完。你需要按状态码决定读取还是丢弃响应体,并在完成后关闭 Body;否则连接可能无法复用,长时间运行的服务还可能积累连接和相关资源。
学习目标
- 按状态码选择读取、限量读取或丢弃响应体
- 正确关闭
Response.Body,理解它与连接复用的关系 - 识别“大响应体直接丢弃”带来的流量与内存风险
响应体为什么必须处理
http.Client.Do 返回后,响应头已经可用,但响应体仍通过 resp.Body 持续读取。对 HTTP/1.x 来说,Transport 通常只有在前一个响应体被读取到 EOF 并关闭后,才有机会把该连接安全放回空闲连接池;只调用 Close 而没有消费完数据,可能放弃这次复用机会。
对 HTTP/2,多个请求可以共享一条连接,但响应体仍必须及时关闭。长期不读也不关会占用流控窗口、内存和请求相关资源,因此“拿到响应就忘记 Body”在任何协议版本下都不是安全做法。

按状态码消费 Body
下面的示例使用 httptest.Server 构造本地上游,并用 httptrace 观察连接是否复用。成功响应完整读取;错误响应只保留前 256 字节用于诊断,再把剩余的小型响应体丢弃到 EOF,最后统一关闭。
package main
import (
"context"
"fmt"
"io"
"net/http"
"net/http/httptest"
"net/http/httptrace"
)
func fetch(client *http.Client, url string) error {
req, err := http.NewRequestWithContext(context.Background(), http.MethodGet, url, nil)
if err != nil {
return err
}
trace := &httptrace.ClientTrace{
GotConn: func(info httptrace.GotConnInfo) {
fmt.Printf("got conn: reused=%v\n", info.Reused)
},
}
req = req.WithContext(httptrace.WithClientTrace(req.Context(), trace))
resp, err := client.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
if resp.StatusCode < 200 || resp.StatusCode >= 300 {
// 只保留有限错误详情,避免把未知大小的错误页全部读入内存。
preview, err := io.ReadAll(io.LimitReader(resp.Body, 256))
if err != nil {
return err
}
// 此处上游响应很小,因此安全地读到 EOF,保留连接复用机会。
if _, err := io.Copy(io.Discard, resp.Body); err != nil {
return err
}
return fmt.Errorf("unexpected status %d: %q", resp.StatusCode, preview)
}
body, err := io.ReadAll(resp.Body)
if err != nil {
return err
}
fmt.Printf("status=%d body=%q\n", resp.StatusCode, body)
return nil
}
func main() {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/fail" {
http.Error(w, "upstream unavailable", http.StatusBadGateway)
return
}
fmt.Fprint(w, "ok")
}))
defer server.Close()
client := &http.Client{}
_ = fetch(client, server.URL+"/ok")
if err := fetch(client, server.URL+"/fail"); err != nil {
fmt.Println("error:", err)
}
}预期输出
got conn: reused=false
status=200 body="ok"
got conn: reused=true
error: unexpected status 502: "upstream unavailable\n"第二次请求出现 reused=true,说明第一次响应体被完整消费并关闭后,连接进入了可复用状态。实际网络环境中的连接是否最终复用,还会受到服务端 Connection: close、空闲超时、协议协商和网络错误等因素影响。
读取、丢弃与关闭的边界
业务需要响应内容时,用 io.ReadAll 只适合明确受控的小响应;对可能很大的正文,应使用流式解码器或 io.LimitReader 限制读取量。错误响应也不要为了“强行复用连接”而无上限地 drain,否则可能把一个超大错误页完整下载下来。
如果你确认剩余响应很小,可以 io.Copy(io.Discard, resp.Body) 读到 EOF 后再关闭,以提高 HTTP/1.x 连接复用概率。若响应大小不可控或已经超出业务限额,应优先及时 Close 并接受该连接可能不能复用,而不是为了连接池牺牲资源上限。
处理下游响应时,真正的完成条件不是“已经拿到状态码”,而是“需要的数据已按上限读取或明确放弃,并且 Body 已关闭”。把这一步固定进客户端封装,才能让连接复用和资源占用长期保持可控。