traceID为空或重复的根本原因是context.Context未正确贯穿请求生命周期，常见于误用context.Background()、goroutine未传入context、第三方库未透传context，以及key冲突或提取方式错误。
为什么 traceID 总是为空或重复？
根本原因通常是 context.Context 没有被正确贯穿请求生命周期，或者中间件/Handler 中误用了 context.Background() 或 context.TODO() 替代传入的请求上下文。Go 的 context 是不可变的，每次调用 context.WithValue() 都返回新实例，若下游没接收并继续传递这个新 context，traceID 就断了。
常见错误场景：
- HTTP Handler 里直接用
context.Background()创建子 context，丢弃了 request 自带的 context - goroutine 启动时没显式传入携带 traceID 的 context，导致新协程日志无 traceID
- 使用第三方库（如
database/sql）执行查询时，没把 context 传进去，DB 日志就脱离链路
如何安全地往 context 注入和提取 traceID？
必须用自定义 key 类型（避免字符串 key 冲突），且只注入一次（通常在入口 middleware）。提取时用同一类型 key，配合类型断言判断是否存在。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义 key：
type traceKey struct{}，全局唯一变量var TraceKey = traceKey{} - 注入：
ctx := context.WithValue(r.Context(), TraceKey, traceID)（r是*http.Request） - 提取：
if tid, ok := ctx.Value(TraceKey).(string); ok { /* 使用 tid */ } - 切勿用
string作 key，比如context.WithValue(ctx, "trace_id", ...)—— 不同包可能撞 key，值被覆盖
logrus/zap 日志库怎么自动带上 traceID？
不能靠全局 logger 实例硬编码 traceID，必须让每条日志能动态读取当前 goroutine 的 context 中的值。推荐用 hook 或字段注入方式，而非修改 logger 初始化逻辑。
以 logrus 为例：
- 写一个
logrus.Hook，在Fire()里尝试从logrus.Entry.Context提取 traceID（要求调用方已设置entry.WithContext(ctx)） - 更稳妥的做法：封装日志函数，如
LogWithTrace(ctx, "msg", fields...)，内部先log.WithField("trace_id", getTraceID(ctx)) -
zap推荐用zap.AddCallerSkip(1)+logger.With(zap.String("trace_id", tid))组合，避免每次手动加字段；注意不要反复With()生成新 logger 实例造成内存开销
gRPC 场景下 traceID 怎么跨进程透传？
HTTP 是靠 header（如 X-Trace-ID），gRPC 则依赖 metadata。客户端发请求前把 traceID 写进 metadata.MD，服务端从 grpc.ServerTransportStream 的 Header() 里解析出来，再塞进 context。
关键点：
- 客户端：
md := metadata.Pairs("trace-id", traceID); ctx = metadata.NewOutgoingContext(ctx, md) - 服务端中间件：用
grpc.UnaryServerInterceptor，调md, _ := metadata.FromIncomingContext(ctx)，再ctx = context.WithValue(ctx, TraceKey, md.Get("trace-id")) - 务必检查
md.Get("trace-id")返回的是[]string，取[0]即可，空 slice 时需 fallback（如生成新 traceID）
跨语言调用时，traceID header 名要对齐（比如都叫 trace-id 而不是 X-B3-TraceId），否则链路会断。实际部署中，最容易被忽略的是异步任务——比如发 MQ 消息后由另一个服务消费，这时 traceID 必须序列化进消息体，并在消费者侧手动重建 context。
