Go语言怎么跨协程传递Context-Golang-PHP中文网

context.withvalue 的 key 不能用 string，因为 ctx.value() 内部用 == 比较 key，不同包中定义的相同字符串字面量是独立对象、地址不同，导致下游取值返回 nil；必须用未导出空 struct 类型（如 type tracekey struct{}）配全局唯一变量作 key，并显式调用 r.withcontext(newctx) 向下透传。

go语言怎么跨协程传递context

context.WithValue 的 key 为什么不能用 string

因为 ctx.Value() 内部用 == 比较 key，而不同包里写的 "trace_id" 是两个独立字符串对象，内存地址不同。哪怕内容一样，ctx.Value("trace_id") 在下游也拿不到值，返回 nil。

常见错误写法：

ctx = context.WithValue(r.Context(), "trace_id", id)
// 下游调用
id := ctx.Value("trace_id") // ← 这里是 nil！

正确做法是定义未导出的空 struct 类型，全局唯一实例：

type traceKey struct{}
var traceKeyKey = traceKey{}
存取必须配对：context.WithValue(ctx, traceKeyKey, id) 和 ctx.Value(traceKeyKey)

HTTP 中间件里注入了 traceID，但 handler 拿不到

根本原因是没把新 context 绑回 *http.Request。中间件里调了 context.WithValue(r.Context(), ...)，但忘了执行 r = r.WithContext(newCtx)，后续 handler 收到的还是原始 request。

必须显式替换并传递：

中间件末尾加 r = r.WithContext(ctx)
再调 next.ServeHTTP(w, r)
否则所有下游逻辑看到的仍是旧 context，Value 查不到，Done 也收不到取消信号

goroutine 里 traceID 突然变空

Go 的 go 语句不自动继承父 goroutine 的 context —— 它捕获的是闭包变量，而那个变量可能指向已过期或未注入 traceID 的 context。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

现象：handler 中打印正常，但 go func() { log.Printf("%s", TraceIDFromContext(ctx)) } 输出空字符串。

解决方式只有一种：

显式传入当前 context：go func(ctx context.Context) { ... }(r.Context())
如果启动多个 goroutine，每个都必须传同一派生 context（比如带 timeout 的），不能各自用 context.Background() 或重复 new
切忌把 context 存进 struct 长期持有，会导致取消失效、goroutine 泄漏

gorush 类项目中协程间 context 传递的关键点

gorush 这类高并发服务，大量后台 job（如队列处理、metrics 上报）通过 g.AddRunningJob(func(ctx context.Context) error { ... }) 启动，这些长期运行的协程依赖 context 的取消信号做 graceful shutdown。

关键实践：

主 context 应从 context.Background() 派生，带超时或 cancel 控制生命周期
HTTP 请求路径中，中间件生成的带 traceID 的 context 必须逐层向下传递，不能断在某一层
推送任务分发到 worker 协程时，应基于请求 context 派生子 context（如加 WithTimeout），而不是直接用顶层 context
优先解析标准 header：traceparent（W3C）→ X-Trace-ID → X-Request-ID；注意 X-Request-ID 不保证唯一，仅作保底

最易被忽略的是：生成新 traceID 仅限上游完全未传时；一旦 header 有值，必须复用，禁止覆盖 —— 否则链路会断在第一个转发节点。