RequestID中间件不能只靠uuid.NewString()生成，因其忽略上游透传、导致链路断裂；必须优先复用X-Request-ID等header中的ID，缺失时才生成，并同步写入响应头与context，确保全链路一致。
RequestID中间件为什么不能只靠 uuid.NewString()
直接用 uuid.NewString() 生成 ID 放进 ctx 或 header，看似能“有 ID”，但实际在分布式或重定向/代理场景下会断链。比如 Nginx 转发时没透传 X-Request-ID，下游 Echo 就会新建一个，导致同一次请求前后两个 ID。真正可用的中间件必须支持「优先复用上游传入的 ID，缺失时才生成」。
- 检查请求 header 中是否存在
X-Request-ID、X-Trace-ID等常见字段（按业务约定选 1–2 个） - 若存在且格式合法（如长度 8–32 位、只含字母数字和短横），直接复用，不重新生成
- 若不存在，再调用
uuid.NewString()或更轻量的rand.String(12)（避免 UUID 的性能开销） - 务必把最终 ID 同时写回响应 header（如
w.Header().Set("X-Request-ID", reqID)），方便前端或网关日志对齐
如何让 RequestID 在整个 Echo 请求生命周期中可访问
Echo 的 echo.Context 本身不带原生 context.Value 透传能力，得靠 c.Set() + 自定义方法封装，否则 handler 里每次都要手动从 header 解析，容易漏或不一致。
- 中间件中生成好
reqID后，立刻调用c.Set("request_id", reqID) - 在 handler 中统一用
c.GetString("request_id")获取，不要重复解析 header - 如果要用标准
context.Context（比如传给数据库驱动或日志库），需用c.Request().Context()并注入：ctx := context.WithValue(c.Request().Context(), "request_id", reqID) c.SetRequest(c.Request().WithContext(ctx))
- 注意：Echo v4.10+ 支持
c.Request().Context()是可变的，但旧版本需确保中间件顺序——RequestID 中间件必须在所有依赖它的中间件（如日志、监控）之前注册
和 Zap 日志集成时常见的坑
很多人加了 RequestID 中间件，但 Zap 日志里还是看不到，问题往往出在 logger 实例没绑定上下文，或者用了全局单例 logger。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 不要在中间件外创建全局
zap.Logger，而应在每个请求中通过c.Get("logger")拿到已注入 request_id 的 logger 实例 - 推荐做法：中间件中构建带字段的 logger：
logger := zap.L().With(zap.String("request_id", reqID)) c.Set("logger", logger) - handler 中直接用
c.Get("logger").(*zap.Logger).Info("handled")，避免每次调用With()新建实例（性能损耗） - 如果用了
zap.RedirectStdLog()，它默认不读取 context 字段，必须改用logger.Desugar().Sugar()替代原生log.Printf
要不要用 OpenTelemetry 替代手写 RequestID 中间件
纯 RequestID 透传，不用；但只要涉及跨服务调用、DB 查询耗时统计、错误归因，手写就很快见顶。OpenTelemetry 的 otelhttp 和 echo-otel 能自动注入 traceparent、提取 span context、上报指标，比维护自定义 header 规则可靠得多。
- 简单场景（单体应用 + Nginx 日志关联）：手写中间件够用，代码不到 20 行
- 已有 gRPC/HTTP 多语言服务：必须上 OTel，否则
X-Request-ID和trace-id格式不兼容，Zipkin/Jaeger 查不到完整链路 - Echo 集成 OTel 的关键点：注册
otelhttp.NewMiddleware()作为最外层中间件，并确保所有 outbound HTTP client 都 wrap 了otelhttp.Transport - 别忽略采样率配置——开发环境设
AlwaysSample()，生产环境用ParentBased(TraceIDRatioBased(0.01))防爆内存
RequestID 是链路追踪的起点，但不是终点。真正难的是保持跨 goroutine、跨 HTTP/client、跨日志输出的一致性，这些地方稍不注意，ID 就会“消失”或“分裂”。
