context.Context 是链路追踪的起点，因 Go 无隐式上下文传递机制，必须通过它显式携带 traceID/spanID，否则跨 goroutine 或服务调用时链路断裂。
为什么 context.Context 是链路追踪的起点
Go 没有隐式传递追踪上下文的机制，所有跨 goroutine 或服务调用的 traceID/spanID 都必须显式携带。不基于 context.Context 传递，就等于放弃 Go 原生的传播能力，后续注入 HTTP Header、gRPC Metadata、日志字段都会断裂。
常见错误是直接用全局变量或 thread-local（Go 里没有）存 traceID，结果在并发请求中混用 span，导致链路错乱甚至 panic。
- 所有入口函数（HTTP handler、gRPC server method）必须从
req.Context()提取或生成新context.Context - 下游调用前，必须用
context.WithValue()注入traceID和spanID，但更推荐用 OpenTracing/OpenTelemetry 的StartSpanFromContext()封装 - 避免把 trace 相关字段塞进业务 struct，它们属于控制流，不是数据流
HTTP 客户端如何透传 traceparent Header
W3C Trace Context 标准要求使用 traceparent（格式：00-<trace-id>-<span-id>-01</span-id></trace-id>）而非自定义 header，否则无法与 Jaeger、Zipkin、OTLP 后端兼容。
手动拼接容易出错：大小写、分隔符、版本号缺失、spanID 不是 16 进制 16 字节——这些都会让后端丢弃 span。
立即学习“go语言免费学习笔记（深入）”；
- 用
otelhttp.NewTransport()替代原生http.DefaultTransport，它会自动读取 context 中的 span 并注入traceparent - 若必须手写 client，调用
propagators.Extract()+propagators.Inject()，不要直接操作req.Header.Set() - 注意：
http.Client.Do()不会继承父 context 的 timeout/cancel，需显式传入带超时的 context
gRPC 调用怎么让 metadata.MD 携带 trace 信息
gRPC 默认不传播 context 中的 trace 数据，必须通过 metadata.MD 显式注入。漏掉这步，服务间调用就断链。
错误做法是把 traceparent 当作普通 metadata key 写死，比如 md.Append("traceparent", "...") —— 这样无法被 OpenTelemetry 的 gRPC interceptor 自动识别。
- 使用
otelgrpc.Interceptor()作为 unary 和 stream client/server option，它会自动处理 metadata 的 extract/inject - 若需自定义 metadata，用
otel.GetTextMapPropagator().Inject()写入metadata.MD，key 必须是小写（如"traceparent"），不能带下划线或大写 - server 端拦截器要调用
otel.GetTextMapPropagator().Extract()从metadata.MD恢复 context，否则 span.parent 为空
如何避免 span 泄露和 context 取消混乱
忘记调用 span.End() 是最常见内存泄漏源：每个未结束的 span 会持有 goroutine、timer、map 引用，压测时 QPS 上去后 RSS 暴涨。
另一个坑是 span 生命周期和 context cancel 混用：用 context.WithTimeout() 创建子 context，但 span 仍绑定原始 context，导致超时后 span 还在上报。
- 始终用
defer span.End()，哪怕在 error return 前也要确保执行 - 创建 span 时传入正确的 context：
tracer.Start(ctx, "db.query")，不是tracer.Start(context.Background(), ...) - 避免在 defer 中捕获 panic 后直接 return；panic 会跳过 defer，应改用 recover + 显式
span.End() - 日志打点若集成 otel，需用
span.AddEvent()，而不是只写 console log
func handleRequest(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
span := tracer.Start(ctx, "http.handler")
defer span.End() // 关键：必须在这里
if err := doWork(span.Context()); err != nil {
span.RecordError(err)
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
}
链路追踪不是加个 SDK 就完事，真正难的是让每个 goroutine、每次 HTTP/gRPC 调用、每条日志都对齐同一个 trace 上下文。漏掉任意一环，整条链就变成孤岛。
