Go微服务间必须显式提取、注入和透传trace上下文，否则链路断裂；HTTP入口需用otel.GetTextMapPropagator().Extract()解析traceparent并注入request context，客户端须在每次Do前Inject，goroutine中应传span而非ctx，gRPC需通过metadata.MD透传且key全小写。
Go 微服务间无法自动传播 context.Context，必须靠显式提取、注入和透传，否则 trace ID 断链、日志无法关联、超时控制失效。
HTTP 请求中如何从 header 提取并注入 trace 上下文
入口 HTTP handler 或 middleware 必须解析 traceparent（不是 X-Trace-ID），否则下游 OTel SDK 拿不到 parent span 信息。OpenTelemetry Go 的 otelhttp.NewHandler 会自动做这事，但前提是你的 handler 真被它包装了；手写中间件时容易漏掉关键步骤：
- 用
otel.GetTextMapPropagator().Extract()解析r.Header，别自己字符串切分 —— 格式容错差、不支持tracestate - 提取失败时，不要传
nilcontext，而要用context.WithValue(r.Context(), spanKey, newRootSpan())fallback 创建 root span - 解析后得到的
context.Context必须通过r = r.WithContext(newCtx)注入到 request，否则下游调用r.Context()仍是空壳 - 若用 Gin/Echo，
c.Request = c.Request.WithContext()在 v1.9+ 已不生效，得用c.Set("span", span)+ 显式参数传递
HTTP 客户端 outbound 调用如何透传 traceparent
http.Client.Do() 不读 context 里的 span，也不会自动塞 header —— 这是高频断链点。每次发请求前必须手动 Inject：
- 用
otel.GetTextMapPropagator().Inject(ctx, &httpHeaderCarrier{req.Header})，其中httpHeaderCarrier要实现TextMapCarrier接口 -
traceparentheader 名必须全小写（"traceparent"），大写或驼峰会被某些代理/SDK 忽略 - 别用
req.Header.Set()，改用req.Header.Add()避免被其他中间件覆盖（如某些 auth middleware 会重写 header） - 如果下游服务也用 OTel，记得同时注入
tracestate，否则 vendor-specific 标签丢失（如采样率决策）
goroutine 中 context 和 span 为什么总是丢失
Go 的 goroutine 不继承父 goroutine 的 context，go func() { db.Query(ctx) }() 里 ctx 一进去就变成 background，span 自动降级为 root。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 最稳妥做法是把
span对象（而非ctx）作为参数传进 goroutine：go doWork(span)，因为span是 thread-safe 的，且自带绑定的 context - 若必须传 context，得显式派生：
go func(ctx context.Context) { ... }(ctx)，不能直接引用外部变量 - DB 查询、RPC 调用等底层库若支持 context，优先用它们原生接口（如
db.QueryContext()），避免自己封装时漏传 - 日志打点时别依赖
ctx.Value()获取 trace_id —— goroutine 里可能为空，应从传入的span或ctx显式提取后缓存
gRPC 场景下 metadata 透传的正确姿势
gRPC 不走 HTTP header，得用 metadata.MD 透传上下文，但它不会自动跨跳传播（A→B→C 时，B 必须主动读+改+再传给 C）：
- 客户端注入：用
metadata.NewOutgoingContext(ctx, md)，不是md.Set()—— 后者大小写敏感、会覆盖重复 key - 服务端读取：用
metadata.FromIncomingContext(ctx)，拿到的是metadata.MD类型，不是原始 map - 透传时别直接
md.Copy()，要重建：newMD := metadata.Pairs("traceparent", tp, "tracestate", ts)，再注入 - key 必须小写（
"traceparent"），gRPC metadata 默认转小写，大写 key 会导致 downstream 读不到
真正难的不是“怎么写代码”，而是每个 outbound 调用点都得手动 Inject、每个 inbound 入口都得 Extract 并注入 request context——漏一次，整条链就断在那。尤其在混合使用 HTTP/gRPC/消息队列的系统里，不同协议的透传逻辑差异容易被忽略。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
