OpenTelemetry 的 context.Context 无法自动透传至 RPC 调用，因 net/rpc 和多数框架不支持 trace 上下文注入/提取；需手动通过 propagation.TraceContext 在请求头中编码 traceparent 等字段，并确保 client 注入与 server 提取使用相同传播器且 key 全小写。
Go RPC调用中 context 为什么传不进 OpenTelemetry span？
因为标准 net/rpc 和大多数第三方 RPC 框架（如 gRPC）默认不自动注入/提取 context 中的 trace 信息。OpenTelemetry 的 context.Context 是 Go 运行时层面的传递机制，而 RPC 协议层（HTTP/2、TCP 序列化等）本身不理解它——你得手动把 span context 编码进请求头或消息体。
gRPC 场景下如何让 otelgrpc 自动透传 trace context？
用 otelgrpc.UnaryClientInterceptor 和 otelgrpc.UnaryServerInterceptor，但必须确保它们被正确注册，且 client/server 都启用。否则 span 会断开，出现「孤立 span」或「parent missing」。
- client 端：创建
grpc.Dial时传入grpc.WithUnaryInterceptor(otelgrpc.UnaryClientInterceptor()) - server 端：启动
grpc.Server时加grpc.UnaryInterceptor(otelgrpc.UnaryServerInterceptor()) - 不要漏掉
otelgrpc.WithTracerProvider(tp)参数（tp是你初始化的trace.TracerProvider），否则用的是默认空 provider，看不到 span - 如果用了 streaming，记得换用
otelgrpc.StreamClientInterceptor和对应 server 版本
net/rpc 或自定义 TCP RPC 怎么手动注入/提取 trace context？
没有现成 interceptor，只能在序列化前手动把 trace context 编码进请求结构体，服务端再解码还原。OpenTelemetry 提供了 propagation.TraceContext 作为标准传播器，它把 trace ID、span ID、trace flags 等塞进 HTTP header 风格的 map，你可以复用这套逻辑。
- client 发起调用前：
ctx = propagation.TraceContext{}.Inject(ctx, &yourRequest.HeaderMap)，其中yourRequest.HeaderMap是你协议里预留的 metadata 字段（比如map[string]string） - server 收到请求后：
ctx = propagation.TraceContext{}.Extract(ctx, &yourRequest.HeaderMap)，再用这个 ctx 启动新 span - 别直接传
context.Background()给tracer.Start()，否则 span 无法关联上游 - 注意：
HeaderMap必须是可读写的引用类型（如指针或 struct 字段），否则 extract 失败不报错但静默失效
为什么 span 显示 parent span ID 为 0000000000000000？
说明上下文没成功传递或 extract 失败，最常见原因是 header key 大小写不一致或格式错误。OpenTelemetry 默认用 traceparent 字段（小写 + 连字符），不是 Traceparent 或 X-Traceparent。
立即学习“go语言免费学习笔记（深入）”；
- 检查 client 注入后，实际发出去的 header key 是不是
traceparent（全小写） - 确认 server 端 extract 时用的是同一个 propagation 实例（
propagation.TraceContext{}），而不是propagation.Baggage{}或其他 - 如果走 JSON over HTTP，别把 traceparent 塞进 body；它必须在 HTTP header 里，否则 extract 会跳过
- 用
otel.GetTextMapPropagator().Inject()替代硬编码 key，更可靠
跨进程 trace 最容易卡在传播这一步——看起来代码都写了，但 header 名字错一位、大小写差一个，span 就彻底断连。调试时先打印出 inject 后的 map 和 extract 前的 map，比猜快得多。
