直接用context.Context传traceID不够用，因为context仅传递traceID字符串，不包含parent span ID、采样标志等完整span上下文，导致下游无法生成正确子span而链路断裂；必须使用W3C TraceContext等标准格式跨进程传递全量上下文。
为什么直接用 context.Context 传 traceID 不够用
因为 context.Context 本身不携带传播所需的 span 上下文（比如 parent span ID、采样标志、baggage），只靠它透传 traceID 字符串，会导致下游服务无法正确生成子 span，链路断裂。真实链路追踪需要跨进程传递完整的 span 上下文，而不仅仅是 trace 标识。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须使用标准传播格式（如 W3C TraceContext 或 Jaeger/Zipkin 的 B3），不能自己拼
traceID-spanID字符串 - HTTP 请求中通过
traceparent（W3C）或uber-trace-id（Jaeger）头传递，不是自定义头名 - gRPC 场景需用
metadata.MD注入/提取，且要注册拦截器，不能只改context.WithValue
如何用 go.opentelemetry.io/otel 实现零侵入 HTTP 中间件
OpenTelemetry Go SDK 提供了开箱即用的 http.Handler 包装器，但默认行为容易踩坑：它会自动为每个请求创建 span，但若没配置采样器，可能全量上报拖垮后端；若没关闭自动注入，还会重复添加 trace 头。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
otelhttp.NewHandler包裹 handler，但必须传入自定义otelhttp.WithSpanOptions控制 span 名称和属性 - 设置采样器：
sdktrace.WithSampler(sdktrace.ParentBased(sdktrace.TraceIDRatioBased(0.01)))，避免 100% 采样 - 禁用自动 header 注入：
otelhttp.WithoutResponseHeaders()和otelhttp.WithoutRequestHeaders()，由业务按需控制 - 示例关键行：
http.Handle("/api", otelhttp.NewHandler(http.HandlerFunc(yourHandler), "api", otelhttp.WithSpanOptions(trace.WithAttributes(attribute.String("layer", "http")))))
otel.Tracer 的生命周期管理为什么不能全局单例
看似方便的全局 tracer := otel.Tracer("my-service") 调用，在微服务多模块场景下会出问题：不同包可能调用时未初始化 SDK，导致返回 noop tracer；更严重的是，若服务热加载模块或存在多个 tracer name，全局变量无法隔离上下文。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- tracer 必须从已初始化的
otel.TracerProvider获取，且该 provider 应在服务启动时完成配置（exporter、sampler、resource） - 避免在工具函数里直接调用
otel.Tracer，应将trace.Tracer作为参数注入 handler 或 service struct - 资源（
resource.WithAttributes(semconv.ServiceNameKey.String("order-svc"))）必须设，否则后端无法按服务聚合 - 注意
TracerProvider是线程安全的，但Tracer实例不是“状态容器”，每次Tracer().Start()才真正创建 span
gRPC 链路中断的三个典型原因及修复点
HTTP 能跑通，gRPC 却看不到完整链路，大概率卡在这三处：客户端没注入 context，服务端没提取 metadata，或者 interceptor 没注册到正确的 server/client 实例上。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 客户端必须用
grpc.WithUnaryInterceptor(otelgrpc.UnaryClientInterceptor())，不是只加context.WithValue - 服务端拦截器注册顺序重要：必须在
grpc.NewServer()时传入grpc.UnaryInterceptor(otelgrpc.UnaryServerInterceptor())，晚于其他拦截器（如 auth）会丢失上下文 - 检查 metadata key 是否小写 —— gRPC 默认转小写，但
otelgrpc提取时依赖原始 key，需用otelgrpc.WithPropagators显式指定 propagator - 若用自定义 codec 或流式接口，需额外接入
otelgrpc.StreamServerInterceptor，Unary 拦截器对 stream 无效
