Go httptrace.ClientTrace 怎样记录连接复用是否命中

如果 Go 客户端开启了连接池，却不知道第二次请求到底有没有复用 TCP 连接，可以给请求挂一个 httptrace.ClientTrace，在 GotConn 回调中直接读取 GotConnInfo.Reused。true 表示这条连接此前已经服务过其他 HTTP 请求；再结合 WasIdle 和 IdleTime，就能判断它是否来自空闲连接池。

最容易被忽略的是，追踪器只绑定当前请求上下文，连接复用则依赖可复用的同一个 http.Client、响应体的正确关闭以及 Transport 的连接策略。下面按这三个线索排查。

先看清三个连接状态字段

GotConn 在 Transport 成功取得连接后触发，它不是“新建连接”的专用回调。判断是否命中复用，重点看下面的字段：

把 ClientTrace 绑定到请求上下文

追踪器要在发起请求前写入请求上下文。下面的最小写法只记录连接状态，不读取、不关闭 GotConnInfo.Conn，因为该连接由 http.Transport 所有。

package main

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

func requestWithTrace(ctx context.Context, client *http.Client, url string) error {
    trace := &httptrace.ClientTrace{
        GotConn: func(info httptrace.GotConnInfo) {
            // Reused 判断是否曾服务过请求；WasIdle 判断是否从空闲池取出。
            fmt.Printf("reused=%t wasIdle=%t idle=%s\n", info.Reused, info.WasIdle, info.IdleTime)
        },
    }

    req, err := http.NewRequestWithContext(
        httptrace.WithClientTrace(ctx, trace),
        http.MethodGet,
        url,
        nil,
    )
    if err != nil {
        // URL 构造失败时直接返回，避免把无效请求交给 Transport。
        return err
    }

    resp, err := client.Do(req)
    if err != nil {
        // GotConn 没有覆盖所有失败路径，最终错误仍以 Do 的返回值为准。
        return err
    }
    // 关闭响应体是连接能够回到可复用状态的重要条件。
    defer resp.Body.Close()
    return nil
}

这里的关键顺序是“创建 trace → 用 WithClientTrace 生成上下文 → 用这个上下文创建请求 → 调用 Do”。如果先执行请求，再把 trace 放进另一个上下文，当前请求不会被追踪。

用第二次请求观察复用命中

单次请求只能证明 Transport 取得了一条连接，不能证明连接池已经复用。应复用同一个 http.Client，连续发出两次请求，并在读取完响应后关闭 body：

func observeTwice(ctx context.Context, client *http.Client, url string) error {
    for i := 1; i 

这段函数还需要在 import 中加入 io。常见的观察结果是第一次 reused=false，第二次可能为 reused=true 且 wasIdle=true。这不是硬编码保证，而是连接、服务端 keep-alive、Transport 空闲策略和请求间隔共同作用的结果。

按现象定位为什么没有复用

• 两次都是 false：先确认两次请求是否共用同一个 http.Client；每次新建 Client 或 Transport，都会把连接池一起换掉。
• 第一次成功、后续偶发 false：检查响应体是否读完并关闭，也检查请求间隔是否超过 Transport 的 IdleConnTimeout 或服务端 keep-alive 时间。
• 只看到了 GotConn：GotConn 只表示成功取得连接，连接失败仍要看 client.Do 返回的错误；不要把缺少回调当成网络成功。
• 使用 HTTP/2：不要把 HTTP/1.1 的空闲连接池直觉套到多路复用上；此时更应把 Reused 当作观测字段，并结合协议和请求日志解释。

小结与常见追问

记录连接复用的最小组合是：同一个 http.Client、请求前用 httptrace.WithClientTrace 绑定 ClientTrace、在 GotConn 中读取 Reused/WasIdle/IdleTime，并在每次响应后处理 body。这样看到的日志才有明确含义。

为什么只打印 Reused 不够？因为它只回答“是否曾使用过”，WasIdle 才能补充连接是否从空闲池取出，IdleTime 则帮助定位空闲过久的问题。

能否在 GotConn 里关闭 Conn？不能。官方文档明确说明该连接由 Transport 管理，业务代码不应读取、写入或关闭它。

httptrace 会跨越重定向吗？它追踪的是一次 RoundTrip；使用 http.Client 跟随重定向时可能发生多次 RoundTrip，需要在客户端层面区分这些请求。

参考资料：Go httptrace.ClientTrace、Go http.Client.Do、Go HTTP Tracing。