直接用 context.Context 传 traceID 不够用，因其仅作值传递载体，不自动生成、传播或上报链路数据，需手动提取、注入和透传，易断链；真正需自动注入、跨协程继承、跨进程透传及框架对齐。
为什么直接用 context.Context 传 traceID 不够用
因为 context.Context 只是传递值的载体，它本身不生成、不传播、不上报链路数据。你手动塞一个 traceID 进去，后续所有函数都得显式从 ctx.Value() 取、再手动塞进日志、再手动传给下游 HTTP Header 或 gRPC Metadata——漏一处，整条链就断了。
真正需要的是：自动注入、跨协程继承、跨进程透传、与中间件/客户端/服务端框架对齐。否则就是“伪链路追踪”，看着有 ID，实际无法串联 Span。
- HTTP 入口需从
Request.Header提取traceparent或自定义 header（如X-Trace-ID），并生成初始Span - 每个出站请求（HTTP/gRPC/DB）必须自动把当前 Span 的上下文写入对应传输载体（
Header/Metadata/context.WithValue） - goroutine 分叉时（如
go fn(ctx)），必须用trace.ContextWithSpan而非原生context.WithValue，否则子协程拿不到 Span
用 go.opentelemetry.io/otel 替代老式 opentracing 的关键原因
opentracing 已归档，且其 Go SDK（github.com/opentracing/opentracing-go）缺乏对 context 生命周期、goroutine 安全、异步 span 结束等细节的控制，容易导致 Span 泄漏或状态错乱。OpenTelemetry 是当前事实标准，Go SDK 原生支持 context.Context 绑定、自动 propagation、多 exporter（Jaeger、Zipkin、OTLP）。
实操上，必须做三件事：
立即学习“go语言免费学习笔记（深入）”；
- 初始化全局
TracerProvider并设置BatchSpanProcessor，否则 Span 写完就丢，根本不上报 - HTTP handler 必须用
otelhttp.NewHandler包裹，不能只靠中间件读 header + 手动 StartSpan - gRPC 客户端和服务端要分别用
otelgrpc.UnaryClientInterceptor和otelgrpc.UnaryServerInterceptor，否则 grpc 调用链断在第一跳
示例：注册 HTTP handler
http.Handle("/api/user", otelhttp.NewHandler(http.HandlerFunc(handler), "GET /api/user"))
如何让 DB 查询也带上 Span（以 database/sql 为例）
标准 database/sql 不感知 tracing，直接调 db.Query 不会自动创建 child Span。必须用封装层，比如 go.opentelemetry.io/contrib/instrumentation/database/sql 提供的 Wrap 函数。
注意两个易错点：
- 不是替换
sql.Open，而是替换sql.OpenDB返回的*sql.DB，即：wrappedDB := otelsql.Wrap(db) - 必须确保
context.Context传入 query 方法，例如wrappedDB.QueryContext(ctx, "SELECT ...")，否则 Span 不会关联到当前 trace - 如果用了 GORM，需额外启用
otgorm插件，并确认 GORM v2 的WithContext(ctx)被正确调用
本地开发时 trace 数据发不出去的常见配置坑
本地跑通但看不到 trace，90% 是 exporter 配置问题。OpenTelemetry 默认不启任何 exporter，必须显式添加。
最简可用组合（对接本地 Jaeger）：
- 启动 Jaeger：
docker run -d -p 6831:6831/udp -p 16686:16686 jaegertracing/all-in-one - 代码中注册 OTLP exporter 指向
localhost:4317，而非 Jaeger 的 UDP 端口（6831）——那是旧版 Thrift 协议，新 SDK 默认走 OTLP/gRPC - 若坚持用 Jaeger exporter（非 OTLP），需单独导入
go.opentelemetry.io/otel/exporters/jaeger并配置 UDP endpointlocalhost:6831 - 检查
TracerProvider是否被赋值给otel.SetTracerProvider，否则otel.Tracer返回的是 noop 实现
验证方式：打印 otel.GetTracerProvider().ForceFlush(context.Background()) 是否返回 nil 错误。
链路追踪不是加个中间件就完事，Span 的生命周期管理、context 传递边界、异步任务捕获、错误标注时机，每一处松动都会让 trace 在某个环节静默消失。
