不能直接用 context.WithValue 存 TraceID，因键必须为私有未导出类型（如 type traceIDKey struct{}）避免跨包冲突，且需显式透传至 goroutine、DB、HTTP client 等所有下游调用，漏一处即断链。
为什么不能直接用 context.WithValue 存 TraceID？
因为 context.WithValue 本身没问题，但多数人忽略两点：键类型不是字符串，且值必须是可比较的。用 string 当键（比如 "trace_id"）会导致不同包里传入的 context 无法被下游正确识别——键不相等，ctx.Value(key) 返回 nil。
实操建议：
- 定义私有未导出类型作键，例如
type traceIDKey struct{}，避免跨包冲突 - 用变量封装键，如
var traceIDKey = traceIDKey{}，确保全项目唯一实例 - 不要把 TraceID 存在
http.Header或中间件外的任意 map 中，否则下游服务拿不到
HTTP 入口如何从 Header 提取并注入 context？
常见错误是只在 handler 开头解析一次，但没透传到 goroutine 内部或子调用链。Go 的 HTTP server 默认为每个请求新建 goroutine，但不会自动继承父 context —— 必须显式传递。
实操建议：
- 从
r.Header.Get("X-Trace-ID") - 若为空，生成新 ID（如用
uuid.New().String()），避免空链路 - 用
ctx := context.WithValue(r.Context(), traceIDKey, traceID)替换 request context - 务必用
http.Request.WithContext(ctx)构造新 request，再传给下游 handler 或中间件
goroutine 和子 context 中 TraceID 为什么会丢失？
典型现象：主逻辑打印了 TraceID，但 go func{} 里 ctx.Value(traceIDKey) 是 nil。根本原因是启动 goroutine 时没传 context，或者用了旧的、未注入的 context 变量。
实操建议：
- 所有
go func()必须接收 context 参数，禁止闭包捕获外部 ctx 变量 - 子任务用
context.WithTimeout(ctx, time.Second*5)等派生，而不是直接用context.Background() - 数据库调用、RPC、HTTP client 请求，全部显式传入带 TraceID 的 ctx，例如
db.QueryRow(ctx, ...) - 日志库（如 zap）需支持 context 注入，否则即使 ctx 有 TraceID，log 里也打不出来
第三方库不支持 context 怎么办？
像某些老版本 redis-go、mongo-go-driver 早期版、或自研 SDK 没暴露 ctx 参数，TraceID 就断在那一层。硬改源码或等升级不现实。
实操建议：
- 用
context.Value+ 全局 goroutine-local 存储兜底（仅限紧急场景），例如用map[uintptr]*string绑定当前 goroutine ID - 更稳妥的是包装一层：写个
TracedRedisClient，构造时存一份 TraceID，在每个方法里手动塞进命令参数或 logger - 优先检查库文档，很多已支持
WithContext方法（如client.Set(ctx, ...)），只是没在入门示例里体现
真正麻烦的不是怎么存 TraceID，而是所有依赖环节都得主动接住它——漏掉一个中间件、一个 goroutine、一个 client 调用，整条链就断了。
