在中间件中通过解析 traceparent 或 X-Trace-ID 头获取 trace_id 并调用 c.Set("trace_id", id) 透传，后续用 c.Get("trace_id") 获取；日志需用 zerolog/zap 等支持上下文的库注入 trace_id；HTTP 客户端调用时须将 trace_id 注入 context 并设 header；本地调试需验证 header 透传与中间件执行路径。
中间件里怎么拿到并透传 trace_id
Echo 的中间件接收 echo.Context，但默认不带链路 ID。你需要在请求入口生成或从上游提取 trace_id（比如从 X-Trace-ID 或 traceparent 头），再存进 c.Set("trace_id", id)。后续 handler 或下游中间件用 c.Get("trace_id") 取——别直接读 header，因为可能被覆盖或没传。
常见错误：在中间件里只生成 ID 却没调用 c.Set()，或者用了 c.Request().Context().Value() 但没配合 context.WithValue 注入，导致下游取不到。
- 推荐优先检查
traceparent（W3C 标准），兼容性更好； fallback 到X-Trace-ID - 生成新 ID 时用
uuid.NewString()，避免时间戳+pid 这种易冲突的组合 - 不要在多个中间件里重复生成 ID，否则链路断裂
日志中间件如何把 trace_id 写进每条日志
Go 标准库 log 不支持动态字段，得换支持上下文注入的日志库，比如 zerolog 或 zap。Echo 中间件里拿到 trace_id 后，要把它塞进 logger 实例的 ctx 或 with 字段里，而不是拼字符串。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
示例（zerolog）：
logger := zerolog.Ctx(c.Request().Context()).With().Str("trace_id", traceID).Logger()
logger.Info().Str("path", c.Path()).Msg("request started")
- 别用
log.Printf("[%s] %s", traceID, msg)—— 日志结构化丢失，grep 困难 - 确保 logger 实例是 request-scoped 的，不是全局单例，否则并发下 trace_id 错乱
- 如果用 zap，必须用
logger.With(zap.String("trace_id", traceID))创建子 logger，不能改全局 core
怎么让 HTTP 客户端请求也带上 trace_id
你自己的服务作为下游调用其他服务时，必须把当前 trace_id 通过 header 透传出去。Echo 中间件本身不处理 outbound 请求，这部分得在业务 handler 里做——但可以在中间件里把 trace_id 注入到 c.Request().Context()，方便后续调用。
实操建议：
ctx := context.WithValue(c.Request().Context(), "trace_id", traceID)
req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)
req.Header.Set("X-Trace-ID", traceID)
- 如果用
http.Client，记得设置Timeout和Transport，否则 trace_id 没发出去就超时了 - 用 OpenTelemetry 的话，直接用
propagators.HTTPFormat{}.Inject()更可靠，不用手动设 header - 别忘了给第三方 SDK（如 redis-go、pgx）也传 context，否则 DB 查询不会出现在同一 trace 里
为什么本地调试时 trace_id 总是空或重复
本地跑多个服务时，常因反向代理（如 nginx、docker-compose 网络）或浏览器缓存 header 导致 traceparent 丢失；而开发环境没配分布式追踪后端（Jaeger / OTLP），又容易误以为 ID 没生成。
排查顺序：
curl -v -H "X-Trace-ID: abc123" http://localhost:1323/api/foo看响应头和日志是否出现 abc123。
- 检查 Echo 的
HTTPErrorHandler是否绕过了中间件——错误路径不走日志中间件，trace_id就不会打出来 - Chrome DevTools 的 Network 面板默认不显示自定义 header，要用
curl或 Postman 验证透传 - Docker 环境下，确保容器间网络互通，且宿主机 hosts 没把 service 名解析成 127.0.0.1
