根本原因是SDK未初始化或导出器未注册：默认NoopTracerProvider静默丢弃Span；须显式调用otel.SetTracerProvider(tp)，配置带endpoint的otlpgrpc导出器并禁用TLS（若collector未启TLS），正确透传context，合理设置ParentBased采样策略。
为什么 otel.Tracer 创建后调用 Start() 却没数据上报？
根本原因通常是 SDK 没初始化或导出器未注册。OpenTelemetry Go SDK 默认是“空实现”（NoopTracerProvider），不主动上报任何 Span，哪怕你写了 tracer.Start(ctx) 也只会静默丢弃。
- 必须显式调用
otel.SetTracerProvider(tp)，其中tp是带导出器的trace.TracerProvider - 导出器（如
otlpgrpc.NewClient）要提前配置好 endpoint，常见错误是写成localhost:4317但本地没跑 collector - 别漏掉
defer tp.Shutdown(context.Background())，否则进程退出前最后一批 Span 可能丢失
用 otlpgrpc.Exporter 连接本地 Collector 总超时或报 rpc error: code = Unavailable desc = connection closed
这基本是网络或协议层没对齐。OTLP/gRPC 导出器默认走 TLS，而本地 otel-collector 默认只开非 TLS 的 4317 端口（gRPC）和 4318（HTTP/JSON），但 Go SDK 不会自动降级。
- 启动 collector 时加
--config=... --set=exporters.otlp.endpoint=localhost:4317，并确认它 log 里有Starting OTLP Receiver on port 4317 - Go 侧创建 exporter 时显式禁用 TLS：
otlpgrpc.NewClient(otlpgrpc.WithEndpoint("localhost:4317"), otlpgrpc.WithInsecure()) - 如果 collector 配了 TLS（比如用自签证书），就得配
otlpgrpc.WithTLSCredentials(credentials.NewClientTLSFromCert(...))，不是简单加WithInsecure()
context.Context 传错导致 Span 断链：为什么子 Span 的 parent 总是空？
Go 的 OpenTelemetry 依赖 context.Context 透传 Span，不是靠 goroutine 局部变量或全局单例。一旦 context 没带 span 或被重置，链就断了。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 从入口开始就要用
trace.ContextWithSpan(ctx, span)把 span 注入 context，再传给下游函数 - HTTP handler 中常用
otelhttp.NewHandler自动注入；手动埋点时，别直接用context.Background()，要用 handler 入参的r.Context() - goroutine 启动新任务时，必须把带 span 的 context 传进去：
go doWork(ctx)，而不是go doWork(context.Background()) - log、metrics、DB 查询等中间件若没显式接收 context，Span 就不会自动关联——得自己用
span.AddEvent()打点，不能指望它们“自动挂上链”
采样率设太高或太低，trace.AlwaysSample() 和 trace.ParentBased(trace.TraceIDRatioBased(0.1)) 有什么实际区别？
采样策略决定哪些 Span 被记录、哪些被丢弃，直接影响可观测性粒度和资源开销。误用会导致关键路径没数据，或日志爆炸。
立即学习“go语言免费学习笔记（深入）”；
-
trace.AlwaysSample()强制所有 Span 上报，适合调试，但生产环境慎用——高 QPS 服务可能打爆 collector -
trace.ParentBased(trace.TraceIDRatioBased(0.1))是推荐的默认策略：根 Span 按 10% 采样，子 Span 继承父级决策，保证整条链要么全有、要么全无 - 注意
TraceIDRatioBased的参数是 float64，写0.01表示 1%，不是整数 1；写错成1会变成 100% 采样 - 如果你用的是 Istio 或其他网关注入了 traceparent header，确保你的采样器识别并尊重
tracestate和 sampling flag，否则可能覆盖上游决策
