Go语言之Context跨协程传递追踪码：语言学习中的分布式链路-Golang-PHP中文网

不能用string作key，因ctx.value()按内存地址比较key，跨包同名字符串不相等，导致取值为nil；正确做法是定义未导出struct类型（如type tracekey struct{}）并全局唯一实例，确保全项目键一致。

go语言之context跨协程传递追踪码：语言学习中的分布式链路

为什么 traceID key 不能用 string

直接写 context.WithValue(ctx, "trace_id", id) 看似能跑通，但跨包调用时必然失效。Go 的 ctx.Value() 比较 key 是基于内存地址相等（==），不是字符串内容相等。两个不同包里各自定义的 "trace_id" 字符串，哪怕内容一样，也是两个独立对象。

后果：下游服务调用 ctx.Value("trace_id") 返回 nil，日志断链、Span 关联失败
正确做法：定义未导出的空 struct 类型，确保全项目只有一个 key 实例：
```
type traceKey struct{}
```
```
var traceKeyKey = traceKey{}
```
存取必须严格配对：context.WithValue(ctx, traceKeyKey, id) 和 ctx.Value(traceKeyKey)

HTTP 中间件里 traceID 注入后为啥下游拿不到

常见错因不是没生成，而是没把新 context 绑回 request。中间件里做了 context.WithValue(r.Context(), ...)，但忘了调用 r = r.WithContext(newCtx)，导致后续 handler 收到的仍是原始 request，其 Context() 里没 traceID。

Go语言（Golang）1.26.0

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

下载

必须在中间件末尾显式替换：r = r.WithContext(ctx)，再调用 next.ServeHTTP(w, r)
优先解析标准 header：traceparent（W3C 格式）→ X-Trace-ID → X-Request-ID；注意 X-Request-ID 不保证唯一，仅作保底
生成新 ID 仅限上游完全未传时；一旦 header 里有值，必须复用，禁止覆盖

goroutine 里 traceID 突然变空了

现象是 handler 中打印正常，但 go func() { log.Printf("%s", TraceIDFromContext(ctx)) } 输出空字符串。根本原因是 Go 的 go 语句不自动继承父 goroutine 的 context —— 它捕获的是闭包变量，而那个变量可能指向旧 context，或压根没注入 traceID。

解决方式只有一种：显式把当前 context 传进去，而不是依赖闭包捕获：

go func(ctx context.Context) {
    log.Printf("trace: %s", TraceIDFromContext(ctx))
}(r.Context())

如果启动多个 goroutine，每个都必须传入同一派生 context（如带 timeout 的），不能各自 new 或用 context.Background()
切忌把 context 存进 struct 长期持有：会导致取消信号失效、goroutine 泄漏、值传递错乱

HTTP 调用下游时 traceID 为何没透传

调用方用了 context.WithValue 存了 traceID，但下游服务收不到，大概率是因为 HTTP client 构造时没把 context 带进去，或者没手动写 header。

必须用 http.NewRequestWithContext(ctx, ...) 或 req.WithContext(ctx)，否则请求发出去时 context 信息丢失
同时要手动把 traceID 写进 header：req.Header.Set("X-Trace-ID", id)，因为 HTTP 协议本身不携带 context
下游服务需从 r.Header.Get("X-Trace-ID") 提取并注入自己的 context，形成闭环
若调用多个下游，所有请求应复用同一个 context（不是每次都 WithValue 新建），否则超时/取消信号无法同步

实际链路中，最易被忽略的是「context 生命周期管理」——它不像变量那样静态存在，而是随派生、超时、取消动态演进。一次漏掉 r.WithContext()，或一个 goroutine 忘了传 ctx，整条 trace 就断在那一环，且问题往往延迟暴露。