使用中间件生成Trace ID并结合Zap日志与OpenTelemetry实现全链路追踪，通过context传递唯一标识，确保日志串联与跨服务传播，关键在于统一ID生成与上下文传递机制。
在Golang中实现Web请求链路追踪，核心是为每个请求生成唯一标识（Trace ID），并在整个调用链中传递该标识。这样可以在日志、中间件、服务间调用中串联起一次请求的完整路径，便于排查问题和性能分析。以下是几种常见且实用的实现方式。
使用中间件生成和传递Trace ID
在HTTP服务入口处通过中间件注入Trace ID，是最基础的做法。该中间件检查请求头中是否已有Trace ID，若无则生成一个新的，并将其写入上下文（context）供后续处理函数使用。
示例代码：
func TraceMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
traceID := r.Header.Get("X-Trace-ID")
if traceID == "" {
traceID = generateTraceID() // 可使用uuid或nanoid
}
ctx := context.WithValue(r.Context(), "trace_id", traceID)
w.Header().Set("X-Trace-ID", traceID)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
func generateTraceID() string {
return fmt.Sprintf("%d", time.Now().UnixNano())
}
在后续Handler中可通过ctx.Value("trace_id")获取该ID，并记录到日志中。
立即学习“go语言免费学习笔记（深入）”；
结合Zap日志输出Trace信息
结构化日志库如Zap支持字段化输出，可在每条日志中附加Trace ID，实现日志串联。
做法是在中间件中将带有trace_id的Logger存入context：
logger := zap.L().With(zap.String("trace_id", traceID))
ctx := context.WithValue(r.Context(), "logger", logger)
处理函数中取出Logger写日志：
if log, ok := r.Context().Value("logger")(*zap.Logger); ok {
log.Info("handling request", zap.String("path", r.URL.Path))
}
跨服务调用传递Trace上下文
微服务架构下，请求会经过多个服务。需在发起HTTP请求时将Trace ID写入Header，确保下游能接续同一链路。
例如使用http.Client时：
req, _ := http.NewRequest("GET", "http://service-b/api", nil)
req.Header.Set("X-Trace-ID", traceID)
// 发起请求...
建议封装一个通用的HTTP客户端，自动携带上下文中的追踪信息。
使用OpenTelemetry标准方案
更完整的链路追踪应采用行业标准，如OpenTelemetry（OTel）。它提供SDK支持Span、Trace、Metrics采集，并兼容Jaeger、Zipkin等后端。
步骤简述：
- 引入
go.opentelemetry.io/otel系列包 - 初始化Tracer Provider，配置Exporter（如OTLP、Jaeger）
- 在Handler中开启Span：
ctx, span := tracer.Start(r.Context(), "http-handler") - 结束时调用
span.End() - 自动传播Context至下游服务（需启用Propagators）
OpenTelemetry优势在于标准化、可视化强、支持自动 instrumentation（如net/http、database/sql等）。
自定义Context传递多级追踪信息
除了Trace ID，还可加入Span ID、Parent Span ID等，构建完整的调用树。可定义结构体保存追踪元数据：
type TraceInfo struct {
TraceID string
SpanID string
ParentID string
}
通过context传递此结构体，在每次进入新调用层级时生成新Span ID，形成父子关系。
基本上就这些。从简单中间件加日志，到接入OpenTelemetry，可根据项目复杂度选择合适方案。关键是统一Trace ID生成与传递机制，保证全链路可见。不复杂但容易忽略的是：别忘了在异步任务或定时任务中手动传递上下文。
