Go httptrace.GotConnInfo 怎样判断连接是否复用

我排查 Go HTTP 客户端延迟时，最容易误读的是“拿到了连接”并不等于“刚建立了连接”。在 ClientTrace.GotConn 中，真正应该看的不是 Conn 本身，而是 GotConnInfo 的三个状态字段：Reused 说明它以前是否服务过请求，WasIdle 说明它是否从空闲池取出，IdleTime 则给出它在空闲池里停留的时间。

判断连接是否复用时，先看 Reused；要判断是否是 keep-alive 空闲池复用，再看 WasIdle 和 IdleTime。不要读取、写入或关闭 GotConnInfo.Conn，它归 http.Transport 管理。

这篇只讨论单次 HTTP 客户端请求中的连接观测，重点是复用失败时怎样把现象和 Transport 配置对应起来。

三个字段分别回答什么

Reused 是最宽的判断：为 true 表示该连接此前已经用于另一个 HTTP 请求；为 false 通常意味着这是第一次使用它。WasIdle 更具体，表示本次取得的连接来自 Transport 的空闲连接池。只有 WasIdle 为真时，IdleTime 才是有解释价值的停留时长。

因此可以按下面的方式读日志：

把 ClientTrace 放进请求上下文

httptrace 通过请求上下文接收回调。下面的函数只记录观测值，并把真正的响应体交给调用方关闭；示例没有对 info.Conn 做任何读写操作。

package main

import (
    "context"
    "fmt"
    "net/http"
    "net/http/httptrace"
)

func tracedRequest(ctx context.Context, client *http.Client, url string) error {
    req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
    if err != nil {
        return err
    }

    trace := &httptrace.ClientTrace{
        GotConn: func(info httptrace.GotConnInfo) {
            // 只记录 Transport 提供的状态，不操作 info.Conn。
            fmt.Printf("reused=%v idle=%v idle_time=%s\\n", info.Reused, info.WasIdle, info.IdleTime)
        },
    }
    req = req.WithContext(httptrace.WithClientTrace(req.Context(), trace))

    resp, err := client.Do(req)
    if err != nil {
        return err
    }
    defer resp.Body.Close() // 关闭响应体，给 Transport 回收连接的机会。
    return nil
}

GotConn 只表示 Transport 成功拿到连接；它不是“请求已经成功”的回调。若拨号失败，不能期待它提供一条失败记录，应结合 client.Do 返回的错误和其他 trace 钩子分析。

用两次请求读出复用信号

观察复用时，关键是复用同一个 http.Transport，而不是每次请求都新建 http.Client 或 Transport。还要完整读取并关闭响应体，否则连接未必能回到空闲池。为了让记录更容易比较，可以让每次请求都绑定同样的 ClientTrace：

transport := &http.Transport{
    MaxIdleConns:        20,
    MaxIdleConnsPerHost: 10,
}
client := &http.Client{Transport: transport}

for i := 0; i 

如果第二次看到 Reused=true 且 WasIdle=true，可以把它解释为空闲连接池复用。若仍然是 false，先不要急着归咎于 httptrace：服务端可能关闭了连接，响应体可能没有正确关闭，或者 Transport 的 keep-alive、每主机空闲连接数和空闲超时配置不允许保留它。

复用失败时先查 Transport 和响应体

默认 Transport 会为后续请求缓存连接，官方也建议复用 Transport，而不是按需创建。排查顺序可以固定为四项：

1. 确认所有请求共享同一个 http.Client 或 Transport；
2. 确认 resp.Body.Close() 在所有成功响应路径都会执行，必要时先读取完 body；
3. 检查是否设置了 DisableKeepAlives=true，它会禁用 HTTP keep-alive；
4. 检查 MaxIdleConnsPerHost 和 IdleConnTimeout，前者限制每个主机保留的空闲连接数，后者限制空闲连接存活时间。

这几项比直接打印 Conn 更有价值。GotConnInfo.Conn 由 Transport 所有，业务代码不应通过它判断连接细节，更不能自行关闭它；连接生命周期应交给 Transport 和响应体协议管理。

并发、重定向和 HTTP/2 的判断边界

ClientTrace 面向一次 http.Transport.RoundTrip。如果 http.Client 跟随重定向，一个用户层面的请求可能对应多次 RoundTrip，回调也可能出现多组记录，不能把它们强行合并成一次连接结论。回调还可能从不同 goroutine 并发调用，记录器需要保证自身状态安全。

此外，连接复用是协议与 Transport 共同决定的现象。HTTP/2 下可能存在多路复用，同一个底层连接承载多个请求；此时不要把“没有新 TCP 连接”简单等同于“所有请求都从 HTTP/1.1 空闲池取出”。你的日志字段应至少包含请求标识、目标主机、Reused、WasIdle 和 IdleTime，再结合错误与响应状态判断。

常见问题

只看 Reused=true 就能证明命中了空闲池吗？不能。它只说明连接此前服务过请求；是否来自空闲池要看 WasIdle。

IdleTime=0 是不是代表连接刚刚新建？不能这样推断。IdleTime 只有在 WasIdle 为真时才有明确语义，其他情况应忽略。

为什么每次都 Reused=false？优先检查 Transport 是否被重复创建、响应体是否关闭、keep-alive 是否禁用，以及服务端或代理是否主动断开连接。

总结

把 Reused 当作“是否曾经使用过”的总开关，把 WasIdle 当作“是否从空闲池取得”的细分信号，把 IdleTime 当作空闲时长辅助信息，就能避免误判。连接复用异常时，沿着共享 Transport、响应体关闭、keep-alive 和空闲池参数逐项排查，比操作 Conn 更安全也更接近根因。