echo中间件严格遵循洋葱模型：注册顺序即包裹顺序，请求时全局→分组→路由级→handler，响应时逆序回退；必须显式调用c.next()才能进入下一层，否则流程中断。
Echo中间件的洋葱模型不是比喻，是实际执行流——不调用 c.Next()，流程就卡死在那一层；注册顺序写反了，整个包裹结构就错位。这是调试时最常卡住的地方。
中间件注册顺序 = 洋葱包裹顺序
Echo 不会自动排序或合并中间件，r.Use(mwA, mwB, mwC) 的结果就是 mwA → mwB → mwC → handler 这个嵌套结构。先注册的在外层，最后注册的紧贴 handler。
- 错误写法：
r.Use(auth); r.Use(logger)→auth包着logger，鉴权失败时连日志都打不出来 - 推荐写法：
r.Use(logger, auth, recovery)→ 日志最先记录请求，鉴权拦截后仍能记下 401，recover 在最外层兜底 panic - 全局
e.Use()、分组g.Use()、路由级r.GET("/x", h, mw)三者叠加后，执行序列为：全局 → 分组 → 路由级 → handler → 路由级 → 分组 → 全局
c.Next() 是流程开关，不是可选装饰
每个中间件函数体内，c.Next() 的位置直接决定逻辑语义。它不返回值，也不抛错，但漏掉就等于主动终止整个链。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 前置拦截（如 JWT 验证）：
if !valid(c) { c.AbortWithStatusJSON(401, ...); return }—— 此时不能调c.Next() - 前后置都用（如计时 + Header 注入）：
start := time.Now(); c.Next(); cost := time.Since(start); c.Response().Header().Set("X-Response-Time", cost.String()) - 纯后置（如 CORS）：
c.Next(); c.Response().Header().Set("Access-Control-Allow-Origin", "*")—— 必须确保响应还没写出，否则Header().Set()会 panic
全局/分组/路由级中间件叠加时的执行路径
层级不是靠“谁先注册”决定，而是靠挂载位置：全局中间件永远最先进、最后出；路由级中间件只包单条路由，且最靠近 handler。
- 示例：
e.Use(globalLog); api := e.Group("/api"); api.Use(apiAuth); api.GET("/user", userHandler, routeMetric) - 一次
GET /api/user的完整执行顺序是：globalLog → apiAuth → routeMetric → userHandler → routeMetric → apiAuth → globalLog - 注意：
routeMetric的后置逻辑在userHandler返回后立即执行，但它看不到apiAuth后置部分里的任何修改（比如apiAuth改了 context，routeMetric能读到；但routeMetric改了 response header，apiAuth的后置部分读不到）
真正容易被忽略的是：中间件里对 c.Response() 的操作必须发生在 c.Next() 之后，且不能假设上游已写 header；而对 c.Request() 的修改（如加 context value）必须在 c.Next() 之前，否则下游拿不到。洋葱不是自动同步的管道，每一层都得自己把数据“递进去”、再“捞出来”。
