otel.Tracer 不能在包级或 init() 中提前调用，否则返回 noop tracer 导致 Span 全部丢失；HTTP 中间件需手动 Extract/Inject traceparent，context.WithValue 无效；生产环境禁用 AlwaysSample()，应使用 ParentBased 采样器。
直接上结论： otel.Tracer 不能在包级或 init() 里提前调用，否则拿到的是 noop tracer，所有 Span 都丢；HTTP 中间件必须手动 Extract/Inject traceparent，context.WithValue 无效；生产环境禁用 sdktrace.AlwaysSample()，要用 ParentBased 采样器。
为什么 otel.Tracer("x") 一调就失效？
OpenTelemetry 的 Tracer 实例必须绑定到已初始化的 TracerProvider。如果在全局变量、init() 或 SDK 初始化前就调用 otel.Tracer("my-service")，它会返回一个不干活的 noop tracer —— 埋点无报错，但 Span 全部静默丢失。
- 常见错误现象：
SpanContext.SpanID()返回全零、Jaeger/OTLP 后端收不到任何数据、span.End()后没日志也没错误 - 正确做法：封装一个
GetTracer()函数，在main()完成otel.SetTracerProvider(tp)后首次调用它 - 别信文档里“先声明再用”的示例——那些示例默认你已确保 SDK 就绪；实际项目里必须加校验，比如
if tp := otel.GetTracerProvider(); tp != nil { ... }
Gin/Echo 等框架里怎么透传 trace context？
Go 标准 http.ServeMux 和主流 Web 框架（Gin、Echo）都不自动解析 traceparent 头，也不会把提取出的 context 注入到 handler 的 context.Context 中。不手动做，链路就在第一个服务断掉。
- 必须用
otel.GetTextMapPropagator().Extract(req.Context(), propagation.HeaderCarrier(req.Header))，不是req.Header.Get("traceparent")然后自己 parse - Gin 用户特别注意：
c.Request.Context()是只读副本，得用c.Request = c.Request.WithContext(newCtx)覆盖，后续 handler 才能拿到带 trace 的 context - 别漏掉设置 Span name：推荐用
req.Method + " " + req.URL.Path，否则所有 HTTP Span 都叫HTTP GET，失去区分度
采样器配置错在哪？为什么上线后链路全没了？
最常被忽略的是采样器和传播器的初始化顺序。这两处一错，整条链路就断在第一个服务里。
立即学习“go语言免费学习笔记（深入）”；
-
sdktrace.AlwaysSample()在生产环境危险：QPS 上千时 exporter 积压、超时、重试风暴，可能拖垮服务 CPU 和网络 - 推荐用
sdktrace.ParentBased(sdktrace.TraceIDRatioBased(0.1))—— 注意：它是按 trace ID 哈希后取 10%，不是每 10 个请求采 1 个；低频服务可能连续几小时没数据，上线前务必验证 - 传播器（propagator）必须在
otel.SetTracerProvider()之后、中间件启动前注册，例如：otel.SetTextMapPropagator(propagation.TraceContext{})，否则Extract/Inject会退化为 noop
事情说清了就结束。最常被忽略的是：采样器配置和传播器初始化顺序，这两处一错，整条链路就断在第一个服务里。
