应使用私有struct{}类型key在入口处注入traceid，优先解析traceparent头并fallback至x-trace-id/x-request-id，grpc需显式透传metadata，日志库须手动桥接context值，异步goroutine需确保context传递。
Context里塞TraceID，不是用context.WithValue随便塞就行
Go的context.Context本身不存业务数据，context.WithValue只是个“临时挂载点”，但滥用会导致类型不安全、key冲突、GC压力——尤其微服务里跨goroutine、跨HTTP/GRPC调用时，TraceID一旦被覆盖或丢弃，链路就断了。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义全局唯一的
traceIDKey，别用string字面量（比如"trace_id"），用私有未导出的struct{}类型做key，避免和其他包冲突 - 只在入口处（如HTTP middleware或GRPC interceptor）从请求头提取
X-Trace-ID或traceparent，然后用context.WithValue注入；后续所有子context都从父context派生，不再重复解析 - 日志库（如
zap）要配置context感知能力，例如zap.AddCallerSkip(1)配合ctx.Value(traceIDKey)自动注入字段，而不是每个logger.Info都手动传
HTTP中间件提取TraceID时，别漏掉X-Request-ID和W3C Trace Context
不同服务可能用不同头传TraceID：X-Trace-ID是老派做法，X-Request-ID常被Nginx或API网关自动生成，而现代分布式追踪（Jaeger、OTel）要求兼容W3C标准的traceparent头。只认一个，链路必然断裂。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先尝试解析
traceparent（格式如00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01），从中提取trace-id部分（第2段） - fallback到
X-Trace-ID，再fallback到X-Request-ID；但注意X-Request-ID不保证全局唯一或可传递，仅作保底 - 如果上游没传任何trace头，就生成新
traceID（用uuid.NewString()），并确保下游调用时通过req.Header.Set("X-Trace-ID", traceID)透传出去
GRPC客户端调用时，metadata.MD必须显式携带TraceID
HTTP靠中间件自动注入，GRPC没这层机制。如果只往context里塞TraceID，但没把它写进metadata，下游GRPC服务收到的context里就是空的——因为GRPC的metadata不会自动映射到context.Value。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 客户端发起调用前，用
metadata.Pairs("x-trace-id", traceID)构造metadata.MD，再用grpc.InjectMetadata(ctx, md)（或更常见的grpc.MetadataCarrier方式）注入到context - 服务端用
grpc.ServerOption注册拦截器，在UnaryServerInterceptor中用metadata.FromIncomingContext(ctx)取头，再塞回context.WithValue - 别用
metadata.AppendToOutgoingContext在服务端响应时加trace头——那是给客户端用的，服务端返回的是GRPC状态，不是HTTP响应头
Logrus/Zap等日志库不自动读Context，得自己桥接
很多人以为只要context.WithValue塞了TraceID，日志库就会自动显示——其实不会。logrus和zap默认完全无视context，必须手动把ctx.Value(traceIDKey)提取出来，作为字段传进去。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 封装一个
WithContext(ctx context.Context) *zap.Logger方法，内部调用logger.With(zap.String("trace_id", getTraceID(ctx))) - 避免在每条日志前都写
logger.With(...).Info(...)，容易漏；更稳妥的是用zap.ReplaceCore写个wrapper，在Write时统一补字段 - 如果用了
logrus，务必禁用logrus.WithContext——它只是把context存为字段，不会自动解包；改用logrus.WithField("trace_id", getTraceID(ctx))
最麻烦的不是怎么加，而是怎么确保不漏：中间件、GRPC拦截器、异步任务启动的goroutine（比如go func() { ... }()）、定时任务——这些地方的context往往不是从HTTP/GRPC入口自然继承的，TraceID最容易在这里消失。
