HTTP/gRPC全链路TraceID透传需统一用context.WithValue存字符串型TraceID，通过中间件/RoundTripper/Interceptor自动注入请求头或metadata，避免手动操作与全局变量，并确保跨goroutine显式传递context。
HTTP请求中如何透传TraceID而不污染业务逻辑
Go服务间调用时，TraceID必须从入口请求头（如 X-Trace-ID）读取，并在下游调用时原样透传。关键不是“怎么加”，而是“怎么不显式写 everywhere”。推荐用 http.RoundTripper 和 http.Handler 统一拦截，避免每个 http.NewRequest 都手动塞 header。
- 入口处用中间件从
r.Header.Get("X-Trace-ID")提取，若为空则生成新uuid.New().String() - 把 TraceID 存进
context.Context，例如ctx = context.WithValue(ctx, traceKey{}, traceID) - 自定义
http.RoundTripper，在RoundTrip前从req.Context()取出 TraceID 并写入req.Header.Set("X-Trace-ID", traceID) - 不要用全局变量或 struct field 存 TraceID——并发下会串
gin/gorilla/mux 等框架里怎么自动注入日志字段
日志库（如 zap 或 logrus）本身不感知 TraceID，必须靠 context 传递 + 日志 hook 补充字段。gin 的 c.Request.Context() 是天然载体，但需确保中间件顺序：trace 中间件必须在 logger 中间件之前运行。
- 用
zap.String("trace_id", getTraceID(c.Request.Context()))手动加字段太重复，改用zap.AddCallerSkip(1)+ 自定义zapcore.Core实现自动注入 - gorilla/mux 没内置 context 传递机制，需在
http.Handler包裹层调用context.WithValue，再传给子 handler - 注意：
logrus.WithContext(c.Request.Context())不会自动读取自定义 key，得自己写logrus.Entry的WithField注入逻辑
gRPC 请求怎么传递 TraceID
gRPC 不走 HTTP header，要用 metadata.MD。客户端发请求前把 TraceID 写进 metadata，服务端用 grpc.UnaryServerInterceptor 提取并塞进 context；反过来，服务端调下游 gRPC 时也要从 context 读出、写回 metadata。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 客户端示例：
md := metadata.Pairs("trace-id", traceID); ctx = metadata.Inject(ctx, md) - 服务端拦截器里用
md, ok := metadata.FromIncomingContext(ctx)取值，再context.WithValue存进去 - 别用
metadata.AppendToOutgoingContext直接追加——它只对当前 RPC 生效，跨服务调用时不会自动透传到下一级 - 如果混用 HTTP 和 gRPC，建议统一用
trace-id小写 key，避免大小写歧义（HTTP header 不区分大小写，但 metadata key 区分）
为什么用 context.WithValue 但不推荐存结构体
context.WithValue 是 Go 官方推荐的上下文透传方式，但它只适合存简单、不可变、小体积的值（如 string、int）。TraceID 正好符合——字符串，只读，无副作用。一旦存 map 或 struct，就可能引发并发写 panic 或内存泄漏。
立即学习“go语言免费学习笔记（深入）”；
- 错误示范：
context.WithValue(ctx, key, &TraceInfo{ID: id, SpanID: s})—— 如果下游修改了这个 struct 字段，上游也会看到，违反 trace 不可变原则 - 正确做法：拆成多个 key，如
traceIDKey{}和spanIDKey{}，各自存 string - 更稳妥：用类型安全的 key（如
type traceIDKey struct{}），避免和其他中间件 key 冲突
真正难的不是传，是保证全链路每一步都经过且不丢——尤其跨 goroutine（比如用 go func() { ... }() 启动异步任务时，必须显式传 context，不能依赖闭包捕获外层变量）。
