OpenTelemetry在Go中必须首行注册TracerProvider和TraceContext传播器，否则span为nil、链路静默断裂；需用otelhttp.NewHandler/NewTransport自动透传traceparent，禁用手动header；资源属性、采样器、OTLP导出配置缺一不可。
直接用 go.opentelemetry.io/otel，别碰 opentracing-go 或 go-opencensus——它们已归档，跨语言链路在 Istio、Jaeger v1.50+、X-Ray 里必然断裂。
TracerProvider 必须在 main() 开头注册，否则所有 span 都是 nil
Go 的 otel.Tracer() 不报错，但没初始化 sdktrace.TracerProvider 时返回的是 noop tracer，日志没 trace_id，HTTP 中间件不生效，问题静默且难排查。
- 必须在
main()第一行就调用otel.SetTracerProvider(tp)和otel.SetTextMapPropagator(propagation.TraceContext{})，缺一不可 - 别在
init()里做：单元测试并发 init 会 panic；配置（如SERVICE_NAME）也还没加载 - 别在 handler 里临时 new：多个 provider 冲突，采样逻辑错乱，span 可能被丢
- 资源属性必须设：
resource.WithAttributes(semconv.ServiceNameKey.String("my-service"))，否则 Jaeger UI 里看不到服务名
HTTP 请求自动透传 traceparent，别手写 header
自己 req.Header.Set("traceparent", ...) 会漏 tracestate，多 vendor 场景下链路在第一个跳就断；手动 extract + StartSpan 还会导致 span 名字全是 "HTTP GET"、没状态码、没 peer.ip。
- 入向：用
otelhttp.NewHandler(http.HandlerFunc(handler), "api")包裹 handler，它自动 extract、创建 span、注入 context、记录 status/path/method、精准结束时机 - Gin/Echo 不支持直接传
http.Handler，得用适配中间件（如ginotel.Middleware），且必须显式传propagation.TraceContext{} - 出向：必须用
otelhttp.NewTransport(http.DefaultTransport)替换 client transport，http.DefaultClient是链路断裂元凶 - 健康检查路径（如
/healthz）建议用otelhttp.WithFilter()过滤，避免污染 trace 数据
数据库 span 断裂或 duration 不准，光 wrap sql.DB 不够
只用 otelsql.Open() 或 otelsql.WrapDriver() 覆盖不了 sql.Tx 内部的 Stmt.Exec、预编译语句、Rows.Scan 等底层调用，span 断裂或耗时统计失真。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用
otelsql.RegisterDriver()注册带 tracing 的 driver，让连接层所有操作都被拦截 - PostgreSQL 推荐
github.com/jackc/pgx/v5/pg驱动，MySQL 推荐官方github.com/go-sql-driver/mysql（需确认版本兼容 otelsql） - 高基数字段（如 user_id、request_id）禁作 span attribute，会撑爆后端存储
- 异步 goroutine 必须显式传入上游
ctx，不能用context.Background()，否则生成 root span，父子关系丢失
OTLP 导出失败不报错，本地开发优先用 stdout
OTLP exporter 默认超时短（5s）、失败静默，连不上 collector 就丢 trace，不 panic 也不 log，非常难定位。
- 本地开发先用
stdouttrace.NewExporter()，一眼看到 span 输出，排除 SDK 初始化问题 - 生产用
otlphttp.NewExporter或otlpgrpc.NewExporter，配合 OpenTelemetry Collector - 检查 collector 地址：HTTP 是
http://localhost:4318，gRPC 是localhost:4317；用curl -v http://localhost:4318/v1/traces测试是否响应 - 采样器别留
sdktrace.AlwaysSample()上线：QPS 一高，exporter 积压、重试风暴、拖垮 CPU 和网络；改用sdktrace.ParentBased(sdktrace.TraceIDRatioBased(0.01))
最容易被忽略的是传播器（propagator）和采样器（sampler）的初始化顺序——这两处一错，整条链路就在第一个服务里彻底断掉，后续所有埋点都白搭。
