使用OpenTelemetry实现Golang微服务请求追踪，通过otel库初始化TracerProvider并配置导出器，结合Jaeger等后端系统；利用otelhttp包装客户端和服务端，自动注入和提取trace上下文；在日志中关联trace_id和span_id，确保链路可查；部署otel-collector统一处理数据，保障上下文传递完整，避免断链。

在Golang微服务中处理请求追踪，核心是实现分布式链路追踪，确保一次请求跨多个服务时能被完整记录和分析。关键方案是使用OpenTelemetry结合支持分布式追踪的后端系统（如Jaeger、Zipkin），通过传递上下文中的追踪信息来串联整个调用链。

使用OpenTelemetry进行自动追踪

OpenTelemetry是目前Go生态中主流的可观测性框架，支持自动注入和传播追踪上下文。

• 引入otel库：安装go.opentelemetry.io/otel及相关组件，包括trace、propagation、sdk等。
• 初始化TracerProvider：在服务启动时配置trace导出器（如OTLP、Jaeger），并将它注册为全局provider。
• 启用上下文传播：使用TraceContext或Baggage propagator，确保HTTP头中的traceparent等字段被正确解析和传递。

在HTTP请求中注入追踪上下文

当微服务间通过HTTP通信时，需在客户端将当前span上下文写入请求头，在服务端从中提取并继续trace。

• 客户端：使用 otelhttp.NewClient 包装http.Client，发送请求时自动注入trace信息到headers。
• 服务端：使用 otelhttp.NewHandler 包装你的HTTP handler，自动从请求头恢复trace context，并创建server span。
• 自定义中间件：若不用otelhttp，可手动读取W3C Trace Context头部（如traceparent），用propagators.Extract恢复context。

记录日志并与trace关联

为了排查问题，日志需要带上trace_id和span_id，方便在ELK或Loki中关联查询。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

立即学习“go语言免费学习笔记（深入）”；

• 从context获取trace信息：span := trace.SpanFromContext(ctx)，再提取span.SpanContext().TraceID()和SpanID()。
• 结构化日志输出：使用zap或logrus等库，在每条日志中加入trace_id字段。
• 建议统一context封装，在请求入口处生成唯一标识并注入context，后续处理直接从中取值。

集成可视化后端（如Jaeger）

采集到的trace数据需要发送到可视化系统才能查看调用链。

• 配置OTLP Exporter：将trace数据通过gRPC发送到collector，再转发给Jaeger。
• 或直接使用Jaeger Exporter（开发环境适用）：直接上报到Jaeger agent或collector。
• 部署Collector：生产环境建议部署otel-collector，统一接收、处理并导出trace数据。

基本上就这些。只要在每个服务中正确初始化otel SDK，包装网络调用，统一日志格式，就能实现完整的请求追踪。不复杂但容易忽略细节，比如context传递中断或propagator未设置，会导致trace断链。