context.Context 不提供追踪能力，仅传递取消、超时和键值对；trace ID 需手动存取、透传与注入，且须用私有类型作 key 保障类型安全。
为什么 context.Context 本身不提供追踪能力
context.context 是一个接口，它只负责传递取消信号、超时和键值对，**不内置 trace id 生成、传播或采样逻辑**。你看到的“请求追踪”其实是把 trace id 当作一个 value 存进 context，并在日志、http header、rpc 调用中手动透传和提取。go 标准库不关心这个 value 是 "trace_id" 还是 "user_id"。
常见错误是直接用 context.WithValue(ctx, "trace_id", id) —— 这会导致类型不安全、难以调试、IDE 无法提示。正确做法是定义一个私有类型作为 key：
type traceKey struct{}
然后用 context.WithValue(ctx, traceKey{}, id) 存，用 ctx.Value(traceKey{}).(string) 取。这样避免 key 冲突，也防止被外部误用。
如何从 HTTP 请求头提取并注入 trace ID
典型场景：前端发来 X-Trace-ID，后端要把它塞进 context，并在下游调用（如 HTTP client、gRPC）里带上。关键点不是“怎么存”，而是“在哪存、谁负责存”。推荐在 HTTP handler 最外层做：
- 检查请求头是否有
X-Trace-ID；没有就生成一个（比如用uuid.NewString()） - 用自定义 key 把它写入 context：
ctx = context.WithValue(r.Context(), traceKey{}, traceID) - 后续所有子 goroutine、中间件、业务逻辑都基于这个 ctx 操作
注意：不要在中间件里反复覆盖 trace ID。如果上游没传，你生成一次就够了；如果传了，就直接复用，别再生成新 ID —— 否则链路就断了。
如何让 HTTP client 自动携带 trace ID 发往下游
标准 http.Client 不会自动读取 context 里的 trace ID，你需要显式构造 header。最稳妥的方式是封装一个带上下文感知的请求函数：
func DoWithContext(ctx context.Context, req *http.Request) (*http.Response, error) {
traceID, ok := ctx.Value(traceKey{}).(string)
if ok {
req.Header.Set("X-Trace-ID", traceID)
}
return http.DefaultClient.Do(req)
}
更进一步，可以用 http.RoundTripper 实现全局注入，但要注意：必须确保该 RoundTripper 是线程安全的，且不能在每次请求都新建 context（会丢失原始 cancel/timeout）。实际项目中，多数人选择在每个调用点手动 set header，反而更可控、更易 debug。
跨 goroutine 时 trace ID 为什么会丢失
这是最常踩的坑：go func() { ... }() 里直接用外层变量 ctx，看似没问题，但如果外层 ctx 是基于 request 的（比如 r.Context()），而你又没用 context.WithCancel 或 context.WithTimeout 显式派生子 context，那么子 goroutine 就可能持有已 cancel 的 ctx，或者根本没继承到 trace ID。
正确姿势是显式派生：
childCtx, cancel := context.WithCancel(ctx)
defer cancel()
go func() {
// 使用 childCtx，不是原始 ctx
log.Printf("trace: %s", childCtx.Value(traceKey{}))
}()
尤其要注意定时任务、异步通知、数据库连接池回调等场景——它们往往脱离原始请求生命周期，但 trace ID 仍需延续。这时候要么提前拷贝必要字段（如 trace ID 字符串），要么用带 timeout 的子 context 并主动管理生命周期。
trace ID 本身只是字符串，真正难的是保持它的语义一致性：同一个请求，在日志、metric、DB 查询、第三方 API 调用中出现的必须是同一个 ID。这要求你在每一个“出口”（HTTP header、gRPC metadata、SQL comment、消息队列属性）都手动注入，没有银弹，只有约定和纪律。
