TraceID 在 goroutine 中丢失是因为 Go 不自动继承父 context，必须显式传参并用私有 struct{} 类型 key 安全存取；日志需封装 WithContext 函数自动注入 trace_id；HTTP 出站须同时设 traceparent 和 X-Trace-ID；入口应按 fallback 顺序解析多类 trace 头。
TraceID 为什么总在 goroutine 里丢
goroutine 启动时不会自动继承父 context，go doWork() 这种写法里 ctx.Value(traceIDKey{}) 必定是 nil。这不是日志库的问题，是 Go 并发模型的天然限制。
- 必须显式传参：
go doWork(ctx)，并在doWork开头就提取：if tid, ok := ctx.Value(traceIDKey{}).(string); ok { ... } - 别用闭包捕获外部变量存 traceID——并发下会串，尤其在循环启动多个 goroutine 时
- 第三方库如
sqlx、redis-go不支持context.Context的，得自己封装或换用github.com/go-redis/redis/v9这类原生支持 ctx 的客户端 - 数据库操作（如 GORM）必须用
db.WithContext(ctx).First(&u)，否则 DB 层日志永远没 trace_id
HTTP 出站请求必须双写 traceparent 和 X-Trace-ID
只设 X-Trace-ID 头，下游用 OpenTelemetry 就收不到；只写 traceparent，老系统可能解析不了。两者不是二选一，是共存关系。
-
traceparent必须严格按 W3C 格式："00-" + traceID + "-" + spanID + "-01"，其中traceID和spanID都是 32 字符小写十六进制，不足补 0 -
X-Trace-ID可用原始 16 字节 hex（如"0af7651916cd43dd8448eb211c80319c"），方便人工排查和兼容旧服务 - 用
req.Header.Add("traceparent", val)而非Set，避免被其他中间件覆盖（某些代理或 SDK 会重写 header） - 如果下游是 Jaeger 或自研系统，加
tracestate头可传递 vendor-specific 状态，比如"otel=00000000000000000000000000000001"
zap.Logger 怎么做到每条日志都带 trace_id 而不手动传
靠每次 logger.Info 都手动加 zap.String("trace_id", tid) 是错的——漏一次就断链，且高频调用下 GC 压力明显。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 定义封装函数：
func WithContext(ctx context.Context, logger *zap.Logger) *zap.Logger，内部做类型断言提取：if tid, ok := ctx.Value(traceIDKey{}).(string); ok { logger = logger.With(zap.String("trace_id", tid)) } - 调用时统一用：
log := WithContext(r.Context(), baseLogger)，后续所有log.Info自动带字段 - 务必加
zap.AddCallerSkip(1)，否则日志里显示的是封装函数行号，不是业务代码位置 - 别复用返回的 logger 实例跨请求——它已绑定当前 trace_id，下次请求要用新 context 重新派生
key 用 string 字面量还是 struct{}？为什么 panic
用 context.WithValue(ctx, "trace_id", id) 看似简单，但会导致 ctx.Value("trace_id") 返回 nil，且编译不报错，排查极难。
立即学习“go语言免费学习笔记（深入）”；
- 必须定义私有未导出类型：
type traceIDKey struct{}，然后用context.WithValue(ctx, traceIDKey{}, id) - 取值时 key 类型必须完全一致：
ctx.Value(traceIDKey{})，不能漏掉{}或写成traceIDKey - Go 官方明确：字符串字面量作 key 是类型不安全的，不同包定义同名 string key 会被视为不同类型，导致取值失败
- 如果忘记做类型断言，直接强制转换：
tid := ctx.Value(traceIDKey{}).(string)，当值为空时 panic；正确写法是：if tid, ok := ctx.Value(traceIDKey{}).(string); ok { ... }
traceparent、X-Trace-ID、X-Request-ID 的 fallback 顺序——只认一个头，上游用不同网关或 SDK 时链路必然断裂。 
