推荐使用 OpenTelemetry 实现 Go 服务链路追踪，通过 otelhttp 自动注入/提取 W3C Trace Context，为 HTTP、DB、gRPC 等操作创建语义化 span 并添加属性，配置 OTLP exporter 上报至 Jaeger 或生产后端，注意 goroutine 中传递带 span 的 ctx 避免断链。
用 OpenTelemetry 实现 Go 服务的链路追踪
Go 生态中推荐使用 OpenTelemetry（OTel） 做分布式链路追踪，它统一了 OpenTracing 和 OpenCensus，是 CNCF 毕业项目，社区活跃、标准统一、厂商中立。核心目标是：给一次请求打上唯一 trace ID，跨服务传递 span，并最终上报到后端（如 Jaeger、Zipkin、Prometheus + Tempo、或云厂商 APM）。
在 HTTP 服务中自动注入和传播 trace 上下文
Go 的 HTTP 客户端和服务端本身不携带 trace 信息，需手动注入/提取。OpenTelemetry 提供了标准的 propagation 机制，推荐使用 W3C Trace Context（traceparent / tracestate）格式，兼容性最好。
- 服务端接收请求时，用
otelhttp.NewHandler包裹 handler，自动从 header 提取上下文并创建 server span - 客户端发起请求前，用
otelhttp.NewClient或手动调用propagators.Extract+propagators.Inject将当前 span context 写入 request header - 确保所有中间件、goroutine 启动、数据库调用等都通过
trace.SpanFromContext(ctx)获取当前 span 并创建子 span
为外部调用（DB、RPC、HTTP）添加语义化 span
单纯 HTTP span 不够，真实链路还包含 MySQL 查询、gRPC 调用、Redis 操作等。建议：
- 使用官方或社区维护的 instrumented client：如
go.opentelemetry.io/contrib/instrumentation/database/sql（包装sql.DB），go.opentelemetry.io/contrib/instrumentation/net/http（用于 outbound HTTP），go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc - 对未覆盖的组件（如自研 SDK），手动创建 child span：
ctx, span := tracer.Start(ctx, "redis.get", trace.WithAttributes(attribute.String("key", key)))，记得span.End() - 添加关键属性（attributes）：如
db.statement、http.url、rpc.service，便于后端过滤和分析
配置 exporter 并连接可观测后端
本地开发可先对接 Jaeger（轻量、可视化强）；生产环境推荐 OTLP over gRPC 直传，支持压缩与重试。
立即学习“go语言免费学习笔记（深入）”；
- 初始化 exporter：
otlpgrpc.NewClient(otlpgrpc.WithEndpoint("localhost:4317"), otlpgrpc.WithInsecure()) - 注册 trace provider：
otel.SetTracerProvider(sdktrace.NewTracerProvider(...))，其中sdktrace.NewSpanProcessor绑定 exporter - 设置全局 propagator：
otel.SetTextMapPropagator(propagation.TraceContext{}) - 启动 Jaeger 后端示例：
docker run -d -p 16686:16686 -p 4317:4317 jaegertracing/all-in-one:latest
补充建议：避免常见坑
链路断开往往不是因为没埋点，而是上下文丢失。
- goroutine 中必须显式传入带 span 的 ctx，
go doWork(ctx)，不能只传原始参数 - 不要用
context.Background()创建新 span，应从入参 ctx 衍生：ctx, span := tracer.Start(parentCtx, "...") - HTTP handler 中若用了中间件（如 JWT 验证），确保中间件也用
otelhttp包裹或手动 propagate - 检查 trace ID 是否一致：打印日志时用
trace.SpanFromContext(ctx).SpanContext().TraceID().String()对比各服务输出
