echo默认不带traceid，因需显式透传；仅用c.set()存id无法被全局日志器感知，必须通过context.withvalue()注入c.request().context()，并确保日志器、http客户端、goroutine均使用该上下文。
为什么Echo默认不带TraceID，而你加了middleware却没透传成功
因为Echo的echo.Context是请求生命周期内的临时对象，每次中间件调用都是同一个echo.Context实例，但如果你在中间件里只往c.Set("trace_id", ...)写，后续Handler里用c.Get("trace_id")能取到——可一旦接入日志库（比如zerolog或zap），日志打出来却没有TraceID，问题往往出在：日志实例不是从c里拿的，而是全局单例，根本没绑定当前请求上下文。
- 别把TraceID塞进
c.Set()就以为万事大吉，必须让日志器感知到当前请求的context.Context - 推荐用
context.WithValue()把TraceID注入c.Request().Context()，再让日志器基于该context.Context构造日志实例 - 确保所有异步操作（如goroutine、
http.Client.Do）都显式传递这个带TraceID的context.Context，否则下游服务收不到
如何在Echo中正确生成并注入TraceID（兼容OpenTracing/OpenTelemetry语义）
不要手动生成UUID然后硬编码拼接，优先复用标准传播格式。如果后端已用OpenTelemetry，直接用otel.GetTextMapPropagator().Extract()从c.Request().Header里提取；如果没有OTel，用github.com/google/uuid生成v4即可，但务必通过X-Trace-ID或traceparent头透传。
- 生成逻辑放在第一个中间件，且仅当请求头无
traceparent和X-Trace-ID时才新建：uuid.NewString() - 注入到
Request.Context()：c.SetRequest(c.Request().WithContext(context.WithValue(c.Request().Context(), ctxKey, traceID))) - 同时写回响应头：
c.Response().Header().Set("X-Trace-ID", traceID)，方便前端或网关追踪 - 若需兼容
traceparent（W3C标准），用otel/propagation.TraceContext{}.Inject()生成并设头
zerolog/zap等日志库怎么自动带上TraceID（不改每行Log代码）
关键不是“给日志加字段”，而是“让日志器知道此刻属于哪个请求”。zerolog支持ctx.Log()，zap支持logger.WithOptions(zap.AddCallerSkip(1)).With(zap.String("trace_id", ...))，但这些都要你手动传。真正省事的做法是：在中间件里替换c持有的日志实例。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 定义一个请求级日志器字段：
zerolog.Ctx(c.Request().Context()).Info().Str("trace_id", traceID) - 更彻底的方案：用
c.Set("logger", zerolog.Ctx(c.Request().Context()))，后续Handler统一用c.Get("logger").(*zerolog.Logger) - zap用户注意：
zap.NewAtomicLevelAt()不能用于请求级，必须用logger.With(zap.String("trace_id", traceID))派生新实例，并存入c - 切勿在全局
zap.L()上With()，那会污染其他请求
跨服务HTTP调用时TraceID丢失的三个典型原因
你在Echo里生成了TraceID、也打进了日志，但调下游服务后，对方日志里TraceID为空——大概率不是生成逻辑错，而是传播环节断了。
- 没把
traceparent或X-Trace-ID从c.Request().Context()里读出来，再塞进http.Request.Header - 用了
http.DefaultClient但没传带值的context.Context，导致req = req.WithContext(ctx)这步漏了 - 下游服务不是Go或没按W3C规范解析
traceparent，此时要降级兼容：手动读X-Trace-ID并写入req.Header.Set("X-Trace-ID", traceID)
TraceID不是加个中间件就能跑通的链路，它依赖每个环节对context.Context的尊重和传递。最容易被忽略的是：goroutine启动时忘记用ctx做参数，或者用go func() { ... }()闭包捕获了旧的context.Background()。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
