opentelemetry 的 tracerprovider 必须全局唯一，因重复初始化会导致 span 关联失败、上下文丢失、采样混乱；须在 main() 中单例初始化并注入各模块，否则 otelhttp/otelgrpc 等组件无法正确传播 traceparent 或生成业务语义 span。
为什么 OpenTelemetry 的 TracerProvider 必须全局唯一？
Go 微服务中链路追踪失效，八成是因为重复初始化了 TracerProvider。它不是“每次需要就 new 一个”，而是整个进程生命周期内只应存在一个实例——否则 span 无法正确关联、上下文丢失、采样策略混乱。
常见错误是：在每个 handler 或 service 初始化时都调用 otelptrace.NewTracerProvider()，导致多个 provider 竞争注册，最终只有第一个生效，其余 tracer 写入静默丢弃。
- 必须在
main()函数最开始初始化，并通过依赖注入或全局变量传递给各模块 - 若使用
otelhttp中间件或otelgrpc拦截器，它们内部会自动从全局otel.Tracer()获取 tracer，而该 tracer 依赖 provider 注册的 exporter 和 processor - 测试时容易忽略：单元测试里反复调用
NewTracerProvider()会导致内存泄漏（exporter goroutine 不退出）
如何让 HTTP 请求头透传 traceparent 而不污染业务逻辑？
Go 的 net/http 默认不自动解析和注入 traceparent，靠手动读写 header 容易漏掉中间件、重定向、client reuse 等场景。
正确做法是用 otelhttp.NewHandler() 包裹 handler，用 otelhttp.NewClient() 替代原生 http.Client——它们底层已封装 W3C Trace Context 协议的解析、生成与传播逻辑。
-
otelhttp.NewHandler()会自动从req.Header.Get("traceparent")提取上下文，并注入到req.Context()中；响应前再把当前 span 的traceparent写回resp.Header - 若已有自定义中间件（如 auth、rate limit），确保它调用
next.ServeHTTP(w, r)时未 clone 或覆盖r.Context()，否则 span 上下文断裂 - 跨服务调用时，用
req = req.WithContext(ctx)把带 span 的 context 传入 client，otelhttp.RoundTripper才能自动注入 header
为什么 gRPC 服务里 Span 名默认是方法全名而不是业务语义名？
otelgrpc 默认将 span 名设为 /package.Service/Method，看着规范，但监控大盘里根本没法快速识别“下单失败”还是“库存扣减超时”。这不是 bug，是设计选择——你需要显式覆盖。
解决方式不是改拦截器源码，而是用 otelgrpc.WithSpanNameFormatter() 注册自定义格式函数，或者更直接地，在业务代码中用 trace.SpanFromContext(r.Context()).SetAttributes() 补充业务标签。
- 推荐组合：保留默认 span name 做协议层标识，额外加
attribute.String("biz_action", "create_order")和attribute.String("status", "failed") - 避免在 span name 中拼接动态参数（如
"create_order_"+orderID），会导致 span 名爆炸、聚合失效 - gRPC server 拦截器里若用了
otelgrpc.UnaryServerInterceptor()，它默认启用otelgrpc.WithTracerProvider(tp)，务必确认传入的是你初始化的那个 provider
本地开发时 Jaeger UI 看不到 span，但日志显示 exporter 已启动？
典型现象：终端打印 Exporting 1 spans，Jaeger UI 的 Search 页面却空空如也。大概率是采样策略或 endpoint 配置错位。
OpenTelemetry SDK 默认采样率是 TraceIDRatioBased(0.001)（千分之一），本地调试几乎看不到数据；同时，jaeger-thrift exporter 的 endpoint 地址必须精确到 :6831（UDP）或 :14268（HTTP），且不能加 http:// 前缀。
- 开发阶段强制全采样：
sdktrace.AlwaysSample()替换默认 sampler - Jaeger agent 模式下用 UDP endpoint
"localhost:6831"；all-in-one 模式用 HTTP endpoint"http://localhost:14268/api/traces" - 检查防火墙或 Docker 网络：宿主机跑 Jaeger，容器跑 Go 服务时，
localhost指向容器自身，需改用 host.docker.internal 或实际 IP
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
