当前位置:首页 > 文章列表 > Golang > Go问答 > Go httptrace.Wait100Continue 怎样定位客户端等待 100 Continue

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

来源:17golang原创 2026-11-17 19:16:08 0浏览 收藏

如果 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删除
Go http.CrossOriginProtection.AddTrustedOrigin 怎样放行受信任来源Go http.CrossOriginProtection.AddTrustedOrigin 怎样放行受信任来源
上一篇
Go http.CrossOriginProtection.AddTrustedOrigin 怎样放行受信任来源
MySQL JSON_OBJECTAGG 遇到重复键时保留哪个值
下一篇
MySQL JSON_OBJECTAGG 遇到重复键时保留哪个值
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1079次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1079次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1244次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1184次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1029次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码