登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go httptrace.Wait100Continue 怎样定位客户端等待 100 Continue

来源:17golang原创

时间:2026-11-17 19:16:08 146浏览 收藏

如果 Go 客户端上传较大的请求体时,看起来在“写请求”阶段停住,先不要把它归因于连接变慢。只要请求带有 Expect: 100-continue,http.Transport 就可能先写请求头,再等服务端允许继续发送请求体。httptrace.ClientTrace.Wait100Continue 正好标记了这个等待点。

排障时最有用的不是单独打印一条回调日志,而是把 WroteHeaders、Wait100Continue、Got100Continue、GotFirstResponseByte 和 WroteRequest 放到同一条时间线上。这样可以看出是等待 100、等待最终响应,还是请求体写入本身失败。

官方地址:https://pkg.go.dev/net/http/httptrace#ClientTrace

源码地址:https://go.dev/src/net/http/httptrace/trace.go

先把 Wait100Continue 放回请求时间线

这个回调的触发条件很窄:请求指定了 Expect: 100-continue,Transport 已经写完请求头,但在写请求体之前等待服务端返回 100 Continue。因此它不是“请求开始”的回调,也不是“服务端响应变慢”的通用标记。

一条简化时间线如下:

阶段回调或字段排障含义
请求头写完WroteHeaders客户端已经把请求头交给 Transport 写出流程
进入等待Wait100Continue请求体尚未开始写,正在等待服务端许可
收到许可Got100Continue服务端确实返回了 100 Continue
写请求结束WroteRequest请求头和请求体的写入结果已汇总,错误在 Err
响应首字节GotFirstResponseByte服务端开始返回响应头字节,不等同于业务响应完成
Go httptrace Wait100Continue Got100Continue 与请求体发送的时间线说明图
图1:Expect: 100-continue 请求时序说明图,展示 Wait100Continue 与 Got100Continue 的位置;这不是抓包截图。

这里有一个容易混淆的点:Wait100Continue 出现并不保证一定会出现 Got100Continue。服务端可以不回 100,或者中间层改变了响应行为;Transport 会按照自己的等待策略结束等待并继续流程。日志里应该把“进入等待”和“收到 100”当成两个独立事实。

用最小追踪器记录一次上传

给请求挂载 trace 时,推荐记录相对耗时和回调名,不要在回调里读取或关闭 Transport 管理的连接。请求体可以用一个可重复读取的 bytes.Reader,这样示例只聚焦时序,不把一次性流的复用问题混进来。

package main

import (
	"bytes"
	"context"
	"fmt"
	"io"
	"net/http"
	"net/http/httptrace"
	"time"
)

func tracedUpload(ctx context.Context, client *http.Client, url string, payload []byte) (*http.Response, error) {
	start := time.Now()
	mark := func(name string) {
		// 统一记录相对耗时,便于比较等待区间,而不是依赖多台机器的墙上时钟。
		fmt.Printf("trace=%s elapsed=%s\n", name, time.Since(start))
	}

	trace := &httptrace.ClientTrace{
		WroteHeaders: func() { mark("wrote-headers") },
		Wait100Continue: func() {
			// 这里表示请求体还没有写出,Transport 正在等 100 Continue。
			mark("wait-100-continue")
		},
		Got100Continue: func() { mark("got-100-continue") },
		GotFirstResponseByte: func() { mark("got-first-response-byte") },
		WroteRequest: func(info httptrace.WroteRequestInfo) {
			// Err 非空时,优先处理写请求阶段的失败,不把它误判为服务端慢。
			if info.Err != nil {
				fmt.Printf("trace=wrote-request-error elapsed=%s err=%v\n", time.Since(start), info.Err)
				return
			}
			mark("wrote-request")
		},
	}

	req, err := http.NewRequestWithContext(httptrace.WithClientTrace(ctx, trace), http.MethodPost, url, bytes.NewReader(payload))
	if err != nil {
		return nil, err
	}
	// 只有需要服务端先检查请求头时才显式启用这个协商过程。
	req.Header.Set("Expect", "100-continue")
	req.ContentLength = int64(len(payload))

	resp, err := client.Do(req)
	if err != nil {
		return nil, err
	}
	// 调用方负责关闭响应体,避免连接无法回收到空闲池。
	defer resp.Body.Close()
	_, _ = io.Copy(io.Discard, resp.Body)
	return resp, nil
}

这个追踪器的重点是“标记关系”,不是制造一套复杂指标。WroteHeaders 到 Wait100Continue 的间隔通常很短;Wait100Continue 到 Got100Continue 的间隔,才是服务端许可等待的直接观察窗口。若没有 100 回调,也要继续看 WroteRequest 是否最终成功。

用 ExpectContinueTimeout 解释等待为什么结束

Transport.ExpectContinueTimeout 非零时,Transport 会在已经写完请求头后,为 Expect: 100-continue 等待服务端的第一批响应头。时间到了,客户端会继续发送请求体;设为 0 则不等待,直接发送请求体。

transport := &http.Transport{
	// 等待窗口只作用于 Expect: 100-continue,不是整个请求超时。
	ExpectContinueTimeout: 2 * time.Second,
}

client := &http.Client{
	Transport: transport,
	Timeout:   15 * time.Second, // 兜住整个请求生命周期。
}

不要把 ExpectContinueTimeout 当成服务端响应超时:它只覆盖“请求头已经写完、请求体尚未写出”的窗口。请求体开始写出后,仍然要结合整体请求超时和 WroteRequestInfo.Err 判断结果。

另外,手工设置 Expect 前要确认服务端和中间层支持这种交互。它适合大请求体、希望先让服务端检查权限或条件的场景;对很小的请求体,额外等待可能反而放大首包延迟。

用时间差判断到底卡在哪里

运行手册里可以把一次请求拆成几个差值,而不是只记录总耗时:

  • wait_start - headers_done:客户端从写完头到进入等待的本地间隔,通常不应被解释成服务端慢。
  • continue_received - wait_start:如果存在 Got100Continue,这是等待许可的直接区间。
  • request_written - continue_received:收到 100 后到请求写完,重点看请求体大小、发送链路和 WroteRequestInfo.Err。
  • first_response_byte - request_written:请求写完后等待服务端开始响应,不再属于 100 Continue 等待。
Go 100 Continue 等待超时 收到 100 和请求体写入失败的排障分支图
图2:客户端等待 100 的排障分支示意图,展示等待超时、收到 100 和写入失败三种结论;这不是运行截图。

判断时可以按下面三个分支走:

  1. 有 Wait100Continue,没有 Got100Continue,但之后 WroteRequest 成功:更像是服务端没有显式回 100,Transport 等待窗口结束后继续发送了请求体。先核对 ExpectContinueTimeout 和服务端协议行为。
  2. 有 Wait100Continue,也有 Got100Continue:客户端确实经历了许可等待。把两者的时间差作为等待指标,不要把它和最终响应时间混成一个数。
  3. WroteRequest 的 Err 非空:请求写入阶段失败。此时优先看连接关闭、请求体读取错误和 Context 取消,不要只看服务端是否返回 100。

线上日志应该保留哪些字段

如果线上只保留一句“POST 慢”,下一次还会重复猜测。建议给每次请求保留一个请求级 trace ID,并记录事件名、相对耗时、是否看见 100、ExpectContinueTimeout 配置值、请求体大小和最终写入错误。不要在回调中打印请求体内容,也不要把认证头写进诊断日志。

type continueTraceSummary struct {
	TraceID       string
	Waited        bool
	GotContinue   bool
	WaitDuration  time.Duration
	BodyBytes     int64
	WriteError    string
}

func classify(s continueTraceSummary) string {
	if s.WriteError != "" {
		// 写入失败优先归为客户端发送故障,避免误报为服务端业务慢。
		return "request-write-error"
	}
	if s.Waited && s.GotContinue {
		// 两个回调都出现时,WaitDuration 才能代表显式许可等待。
		return "waited-for-continue"
	}
	if s.Waited {
		// 没有 100 但最终写成功,通常需要结合等待窗口和代理行为复盘。
		return "waited-without-continue"
	}
	return "no-continue-wait"
}

告警也要有条件:只有等待区间持续超过业务能接受的范围,并且该现象集中出现在带 Expect 的请求上,才值得单独告警。否则一个正常的保护性等待就可能被误判为网络故障。

回滚与复盘:什么时候应该去掉 Expect

如果确认中间层不理解 100 Continue,或小请求体因为等待窗口明显增加了延迟,可以先回滚显式的 Expect 设置,让请求直接发送请求体。回滚前保留同一组 trace 字段,确认等待事件消失、请求写入仍然成功,再决定是否只对大请求体重新启用。

复盘时重点回答四个问题:这次请求为什么需要先发请求头;服务端是否承诺回 100;Transport 的等待窗口是否符合业务;写请求失败是否来自请求体读取或 Context 取消。把这些问题写进变更记录,后续看到 Wait100Continue 就能快速判断处理路径。

常见问题

Wait100Continue 触发了,是不是服务端已经返回 100?

不是。它表示客户端进入了等待阶段;是否真的收到 100 要看 Got100Continue,或者更细粒度地使用 Got1xxResponse 观察 1xx 响应。

没有 Got100Continue,客户端会永远不发请求体吗?

不会按这个回调本身推断“永远”。Transport 的 ExpectContinueTimeout 会影响等待结束后的行为;还要结合 Context 和整个请求超时看最终结果。

把 ExpectContinueTimeout 设大一点就能解决问题吗?

不一定。它只是延长等待窗口,可能让客户端更久才发送请求体。先确认服务端或代理是否会回 100,再按请求体大小和业务延迟目标调整。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>