使用中间件生成并传递Trace ID，结合日志输出与跨服务传递，实现请求追踪；可通过OpenTelemetry构建标准化分布式追踪体系。
在Golang中实现Web请求追踪，主要是为了在分布式系统或复杂服务调用链中定位问题、分析性能瓶颈。通过为每个请求分配唯一标识（Trace ID），并贯穿整个处理流程，可以清晰地看到请求的完整路径。以下是具体操作方法。
使用中间件注入追踪ID
在HTTP服务中，通常通过中间件为每个进入的请求生成或复用一个追踪ID。这个ID会在日志、下游调用中持续传递。
示例代码：
func TracingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 从请求头获取 trace-id，若无则生成
traceID := r.Header.Get("X-Trace-ID")
if traceID == "" {
traceID = generateTraceID() // 可使用 uuid 或 nanoid
}
// 将 trace-id 写入请求上下文
ctx := context.WithValue(r.Context(), "trace_id", traceID)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
func generateTraceID() string {
return fmt.Sprintf("%d", time.Now().UnixNano())
}
在日志中输出追踪ID
为了让日志具备可追溯性，需将 trace-id 与每条日志一同输出。建议使用结构化日志库如 logrus 或 zap。
立即学习“go语言免费学习笔记（深入）”；
以 logrus 为例：
log := logrus.New()
log.SetFormatter(&logrus.JSONFormatter{})
// 在处理函数中获取 trace-id 并加入日志字段
traceID := r.Context().Value("trace_id").(string)
log.WithField("trace_id", traceID).Info("Handling request")
跨服务传递追踪信息
当请求调用其他微服务时，必须将 trace-id 放入 HTTP 请求头中传递下去。
示例如下：
req, _ := http.NewRequest("GET", "http://service-b/api", nil)
traceID := r.Context().Value("trace_id").(string)
req.Header.Set("X-Trace-ID", traceID)
client := &http.Client{}
resp, err := client.Do(req)
这样，下游服务可通过中间件捕获该ID，实现链路贯通。
集成 OpenTelemetry 实现标准追踪
对于更复杂的场景，推荐使用 OpenTelemetry，它提供标准化的分布式追踪能力。
步骤简要：
- 引入依赖：
go.opentelemetry.io/otel - 初始化 tracer provider，配置 exporter（如 Jaeger、OTLP）
- 在中间件中开启 span，并将 trace-id 注入上下文
- 自动或手动记录事件、属性和时间
OpenTelemetry 支持自动插桩，适用于 gRPC、HTTP 客户端等常见组件，适合生产环境。
基本上就这些。从简单中间件加日志，到接入 OpenTelemetry，可根据项目规模选择合适方案。关键是保证 trace-id 贯穿全流程，且不丢失。不复杂但容易忽略细节。
