Go httptrace.ClientTrace Got1xxResponse 怎样记录一百级响应

如果你只用过 httptrace.ClientTrace.Got100Continue，遇到 103 Early Hints 或其他一百级响应时就会发现：这个专用回调并不能表达完整信息。Go 的通用做法是给 ClientTrace 设置 Got1xxResponse，让它接收每条最终非 1xx 响应之前的一百级响应头。

结论：Got1xxResponse 的回调参数是状态码 code、头部 textproto.MIMEHeader 和可返回的 error。它也会覆盖 100 Continue；如果回调返回错误，客户端请求会用这个错误中止。只记录信息时返回 nil，不要把回调当成最终响应处理器。

从旧的 100 Continue 观察方式迁移

Got100Continue 只能告诉你“收到了 100 Continue”，没有状态码和头部参数；Got1xxResponse 则会为每条 1xx informational response 提供 code 与 header。两者可以同时设置，所以迁移时要避免把同一个 100 Continue 计数两次。

这里的“一百级响应”是最终非 1xx 响应之前的中间信息，不是 http.Response 中最终返回给调用方的状态。若需要观察重定向链的每一跳，也不能只依赖一份 ClientTrace，因为该类型的追踪范围是单次 round trip。

把 Got1xxResponse 接到请求上下文

接入方式与其他 httptrace 钩子相同：先创建 ClientTrace，再用 httptrace.WithClientTrace 返回一个带追踪信息的新上下文，最后把这个上下文放入请求。下面的示例只记录一百级响应，不伪造服务器输出：

package main

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

func newRequest(ctx context.Context, target string) (*http.Request, error) {
    trace := &httptrace.ClientTrace{
        Got1xxResponse: func(code int, header textproto.MIMEHeader) error {
            // code 表示 1xx 状态码，header 保留该中间响应的头部。
            log.Printf("收到 1xx: code=%d, link=%q", code, header.Get("Link"))
            // 只做观测时返回 nil，让 Transport 继续处理最终响应。
            return nil
        },
    }
    // WithClientTrace 返回新上下文，不要误以为它会修改原 ctx。
    traced := httptrace.WithClientTrace(ctx, trace)
    return http.NewRequestWithContext(traced, http.MethodGet, target, nil)
}

func fetch(ctx context.Context, target string) error {
    req, err := newRequest(ctx, target)
    if err != nil {
        // 请求创建失败时没有可供追踪的 HTTP 回合，直接保留原错误。
        return fmt.Errorf("创建请求失败: %w", err)
    }
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        // Got1xxResponse 返回的错误也会从这里传出。
        return fmt.Errorf("发送请求失败: %w", err)
    }
    defer resp.Body.Close() // 读取完最终响应后关闭响应体。
    log.Printf("最终响应: %s", resp.Status)
    return nil
}

关键点有三个：WithClientTrace 返回的是新上下文；回调中的 header 只代表当前这一条 1xx；最终响应仍由 Client.Do 返回。不要把 Got1xxResponse 的回调参数当成最终响应的状态或正文。

回调返回错误时会发生什么

这个回调不是只能打印日志的通知点。官方定义允许它返回错误；一旦返回非 nil 错误，客户端请求会用这个错误中止。因此，只有在确实要拒绝某类中间响应时才返回错误，例如业务明确不接受某个 1xx 头部。普通观测、计数和埋点都应返回 nil。

trace := &httptrace.ClientTrace{
    Got1xxResponse: func(code int, header textproto.MIMEHeader) error {
        // 先判断业务允许的 1xx 范围，再决定是否终止本次请求。
        if code  199 {
            return fmt.Errorf("非法 informational status: %d", code)
        }
        // 不把 103 等中间信息误当成最终响应，继续等待最终结果。
        return nil
    },
}

不要在回调里假设只会调用一次，也不要无同步地写共享切片或计数器。ClientTrace 的钩子可能由不同 goroutine 并发调用，记录共享状态时应使用互斥锁、原子计数器或并发安全的日志组件。

迁移时的检查清单

1. 只需要识别 100 Continue 时，可以保留 Got100Continue；需要状态码和头部时改用 Got1xxResponse。
2. 两个回调同时存在时，确认 100 Continue 不会被重复统计。
3. 通过 WithClientTrace 绑定新上下文，并确认请求实际使用了这个上下文。
4. 只记录信息时返回 nil；返回错误意味着本次客户端请求会被中止。
5. 把追踪范围限定为一次 round trip；重定向链的每个请求需要单独理解其追踪边界。

常见追问

Got1xxResponse 会替代 Got100Continue 吗？

从统一观测角度可以替代，但两者并非同一个回调签名。Got1xxResponse 会覆盖 100 Continue，并且官方说明 100 Continue 仍可能触发 Got100Continue，因此同时配置时要自行去重。

能在 Got1xxResponse 里读取最终响应正文吗？

不能。它只接收当前 1xx 的状态码和头部；最终响应由 Client.Do 返回，正文则从最终 Response.Body 读取。

记住这条边界即可：Got1xxResponse 是 HTTP 客户端单次回合中的“一百级响应头观测钩子”，不是最终响应替代品。迁移时补上 code、MIMEHeader、错误返回和并发记录这四个边界，基本就能避免重复统计与误终止请求。