业务流水ID（如orderID、taskID）绝对不能用context.WithValue传递，因其需并发修改且context只提供只读快照、无同步机制；TraceID等元数据则必须用私有类型（如type traceIDKey struct{}）作key，避免字符串key冲突导致取值失败。
不能用 context.WithValue 同步业务流水 ID（如 orderID、taskID），它只适合传 TraceID；而 TraceID 本身也必须用私有类型作 key，否则各协程读不到。
为什么业务流水 ID 绝对不能塞进 context
业务流水 ID（比如 orderID、taskID）通常要被多个 goroutine 并发修改：DB 写入协程更新状态、缓存协程标记完成、日志协程追加审计记录……但 context.Value 返回的是只读快照，且 context 不提供任何同步机制。
常见错误现象：
- 主 goroutine 调用
ctx = context.WithValue(ctx, orderKey, "ORD-123")，子 goroutine 里ctx.Value(orderKey)却是nil或旧值 - 两个 goroutine 同时写
ctx = context.WithValue(ctx, retryCountKey, n+1)，结果重试次数只加了 1 次 - 下游协程轮询
ctx.Value(statusKey)等“处理完成”，永远等不到——因为值根本没变过去
真正该做的是：把 orderID 当作参数显式传入每个 goroutine，状态变更用 sync.Map 或带锁 struct 管理，通知用 channel。
TraceID 必须用私有类型当 key，string 就是 bug
用 "trace_id" 这种 string 当 key，等于在项目里埋雷。不同中间件、SDK、甚至你同事写的工具包，都可能用同名 key，导致值被覆盖或取不到。
实操建议：
- 定义未导出的私有类型：
type traceIDKey struct{}，再声明全局变量var traceIDKey = traceIDKey{} - 注入时：
ctx := context.WithValue(r.Context(), traceIDKey, tid) - 取值时务必加类型断言：
if tid, ok := ctx.Value(traceIDKey).(string); ok { /* 安全使用 */ } - 别在 goroutine 里直接用外层
ctx变量——要显式传参：go processOrder(ctx, orderID)
HTTP 入口如何安全提取并透传 TraceID
从 http.Request 提取 TraceID 不是“读一次就完事”，漏掉任一环节都会断链。
关键步骤：
- 从 header 读：
tid := r.Header.Get("X-Trace-ID")，为空时用uuid.NewString()生成新值（别用time.Now().UnixNano()） - 注入 context：
ctx := context.WithValue(r.Context(), traceIDKey, tid) - 构造新 request：
r = r.WithContext(ctx)，再传给next.ServeHTTP或下游 handler - 启动 goroutine 时，必须把新
ctx传进去：go handleAsync(ctx, ...)，而不是捕获外层变量
常见坑：中间件里改了 ctx，但忘了调 r.WithContext(ctx)，导致下游 handler 拿到的还是原始 r.Context()。
跨服务调用时 TraceID 怎么不丢
context 本身不过网络，HTTP 和 gRPC 必须手动透传字段。
HTTP 客户端侧：
- 从当前 context 取：
if tid, ok := ctx.Value(traceIDKey).(string); ok { req.Header.Set("X-Trace-ID", tid) } - 发起请求前确保用新 context：
req = req.WithContext(ctx)
gRPC 客户端侧：
- 构造 metadata：
md := metadata.Pairs("x-trace-id", tid) - 调用时带上：
client.SomeMethod(ctx, req, grpc.Metadata(md))
注意：gRPC server 端要用 metadata.FromIncomingContext(ctx) 读，不是 req.Header；而且每次 RPC 都得单独传，没有“自动继承”这回事。
最易忽略的一点：所有子 goroutine 启动时，都必须显式接收并使用当前最新的 ctx——哪怕只是用来打日志，也不能靠闭包捕获外层变量。context 是值类型，不是引用，改了父 context 不会自动同步到子 goroutine。
