必须手动将 TraceID 绑定到 Kratos 日志:在 handler 入口从 context 提取 tracing.TraceIDFromContext(ctx),用 log.With(logger, "trace_id", func() string { return tracing.TraceIDFromContext(ctx) }) 实现懒加载,避免空值;根本原因常是 context 未透传、采样率过低或 tracer provider 未正确配置。

TraceID 要进日志,必须显式绑定到 Kratos 的 log.Logger 实例上,而不是靠中间件自动注入;tracing.Server() 生成的 trace context 不会自动写入日志字段,得手动从 context 提取并塞进 logger。
怎么把 TraceID 绑定到 Kratos 日志里
Kratos 日志本身不感知 OpenTelemetry context,tracing.Server() 只负责创建 span 并透传,不会修改 logger 行为。你得在初始化 logger 时主动绑定:
- 用
log.With()把tracing.TraceID()和tracing.SpanID()作为固定字段加进去——但注意:这两个函数返回的是空字符串,除非当前 context 里真有 active span - 更可靠的做法是封装一个带 context 提取能力的 logger helper,比如在 HTTP handler 入口处从
r.Context()取otel.GetTextMapPropagator().Extract()后再调tracing.TraceIDFromContext(r.Context()) - 推荐组合:
log.With(logger, "trace_id", func() string { return tracing.TraceIDFromContext(ctx) })——注意这是 lazy eval,避免在无 context 时 panic
为什么日志里 trace_id 总是空字符串
常见原因不是代码没写,而是 context 没传下去或 span 没激活:
- HTTP handler 里直接用了
r.Context(),但中间件链没调next.ServeHTTP(w, r.WithContext(newCtx)),导致后续 handler 拿到的是原始空 context -
tracing.Server()中间件被加在了 recovery 之后,而 recovery 在 panic 时会新建 context,覆盖掉前面 trace 注入的 context - 用了
log.NewStdLogger(os.Stdout)这类裸 logger,没经过log.With()绑定,自然拿不到任何 trace 字段 - gRPC server 场景下,client 端没配
tracing.Client(),导致下游服务收不到traceparent头,tracing.TraceIDFromContext()就只能返回空
tracing.Server() 和日志字段的兼容性坑
这两者表面配合,实际有隐含依赖关系:
-
tracing.Server()默认使用NoopTracerProvider,哪怕你绑了trace_id字段,也只会打空值——必须提前调otel.SetTracerProvider(tp),且tp得带真实 exporter(如 OTLP) - 采样率影响日志内容:如果用了
ParentBased(TraceIDRatioBased(0.01)),99% 的请求根本不会创建 span,tracing.TraceIDFromContext()就始终为空,日志里也就没有 trace_id -
log.With()绑定的是函数值,不是实时 context;若在 middleware 外层绑定,handler 里换 context 了,字段还是旧的——必须在每个 handler 或最内层业务逻辑里重新提取
真正稳的方式不是靠一次绑定吃遍所有场景,而是把 trace_id 提取逻辑下沉到日志 helper 内部,在每次 h.Info() 前动态读 context;否则跨 goroutine、异步任务、定时 job 里,trace_id 丢得比想象中快得多。



















