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 | 服务端开始返回响应头字节,不等同于业务响应完成 |

这里有一个容易混淆的点: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 等待。

判断时可以按下面三个分支走:
- 有 Wait100Continue,没有 Got100Continue,但之后 WroteRequest 成功:更像是服务端没有显式回 100,Transport 等待窗口结束后继续发送了请求体。先核对
ExpectContinueTimeout和服务端协议行为。 - 有 Wait100Continue,也有 Got100Continue:客户端确实经历了许可等待。把两者的时间差作为等待指标,不要把它和最终响应时间混成一个数。
- 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,再按请求体大小和业务延迟目标调整。
-
502 收藏
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
347 收藏
-
288 收藏
-
182 收藏
-
452 收藏
-
290 收藏
-
452 收藏
-
294 收藏
-
298 收藏
-
135 收藏
-
140 收藏
-
125 收藏
-
371 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习