Golang微服务追踪核心是OpenTelemetry SDK传递trace context并导出span数据，关键在于自动注入context、统一传播协议、可靠导出链路数据。
用 Golang 实现微服务追踪，核心是借助 OpenTelemetry SDK 在服务间传递 trace context，并将 span 数据导出到后端（如 Jaeger、Zipkin 或 OTLP Collector）。关键不在于写多少代码，而在于三点：自动注入 context、统一传播协议、可靠导出链路数据。
1. 初始化全局 Tracer 并配置 Exporter
每个微服务启动时需初始化一个全局 TracerProvider，绑定合适的 exporter。推荐使用 OTLP 协议对接 OpenTelemetry Collector，它能统一接收、处理、转发数据到多种后端（如 Jaeger、Prometheus、Elasticsearch）。
- 安装依赖：
go get go.opentelemetry.io/otel、go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp、go.opentelemetry.io/otel/sdk - 创建 HTTP exporter 指向本地 Collector：
otlptracehttp.NewClient(otlptracehttp.WithEndpoint("localhost:4318")) - 构建 TracerProvider 时启用 batch span processor，提升性能并避免丢 span
2. 在 HTTP 服务中自动注入和提取 trace context
HTTP 是微服务最常用通信方式。OpenTelemetry 提供了 otelhttp 中间件，可零侵入地为 net/http 或 gin/echo 等框架添加 tracing。
- 对标准
http.ServeMux：用otelhttp.NewHandler()包裹 handler，自动从traceparentheader 提取 parent span，并在响应头写回 - 对 Gin：注册
gin.HandlerFunc(otelgin.Middleware())，它会基于请求 path 自动生成 span name，并捕获状态码、错误等属性 - 确保客户端发起请求时也携带 context，例如用
req = req.WithContext(ctx)，再由otelhttp.RoundTripper自动注入 header
3. 跨服务调用时手动传递 context（如 gRPC、消息队列）
HTTP 中间件覆盖大部分场景，但 gRPC、Kafka、RabbitMQ 等需显式传播 context。本质是把当前 span 的 trace ID、span ID、trace flags 等编码进 carrier（如 metadata 或 message header），对方再解码还原。
立即学习“go语言免费学习笔记（深入）”；
- gRPC 客户端：用
grpc.Dial(..., grpc.WithUnaryInterceptor(otelgrpc.UnaryClientInterceptor())) - gRPC 服务端：注册
grpc.UnaryInterceptor(otelgrpc.UnaryServerInterceptor()) - Kafka 生产者：在
msg.Headers中写入otel.GetTextMapPropagator().Inject(ctx, propagation.HeaderCarrier(msg.Headers)) - Kafka 消费者：从
msg.Headers构造 carrier，再用otel.GetTextMapPropagator().Extract(ctx, propagation.HeaderCarrier(msg.Headers))
4. 避免常见陷阱
很多链路“断掉”不是因为没埋点，而是 context 丢失或 span 生命周期管理不当。
- 不要在 goroutine 中直接用原始 context（如
go func(){...}()），必须用ctx := trace.ContextWithSpan(context.Background(), span)显式传入 - 避免 span 过早结束：异步操作（如日志、DB 查询回调）应在 span 结束前完成，否则可能被丢弃
- 不建议手动创建 Span（
tracer.Start(ctx, "xxx")）代替中间件——除非有特殊语义，否则易漏传 context 或属性 - 本地开发时可临时用
stdoutexporter查看 span 输出，确认 trace ID 是否贯穿全程
基本上就这些。OpenTelemetry 的 Golang SDK 设计清晰，只要初始化一次、中间件包一层、跨协程/跨协议传一次 context，整个调用链就能串起来。难点不在代码，而在理解 context 如何流动、在哪被截断、谁负责传播。
