e.Use()是配置全局中间件的唯一方式,它无条件插入所有请求路径的处理链(含404),在路由匹配前执行,按调用顺序串行运行,但不覆盖分组或单路由中间件;Pre()则专用于路由解析前的干预(如HTTPS重定向),与Use()正交。

e.Use() 就是配置全局中间件的唯一方式,它作用于所有注册的路由(包括后续添加的),但不自动覆盖分组或单路由中间件。
为什么 e.Use() 是全局中间件的入口
调用 e.Use(middlewareFunc) 会把中间件追加到 Echo 实例的全局中间件链表末尾。所有请求——无论路径是 /、/api/users 还是 /health——都会经过它。这不是“默认启用”,而是“无条件插入”。
- 它在路由匹配前执行,所以能拦截未注册路径(比如 404 前做 IP 校验)
- 它对
e.Pre()(如重定向)和e.Use()注册的中间件都生效,但Pre()中间件优先级更高(在路由解析前) - 多个
e.Use()按调用顺序串行执行,第一个注册的最先拿到echo.Context
常见错误:以为 Use() 能跳过某些路由
很多人试图在中间件里写 if c.Path() == "/login" { c.Next(); return } 来绕过认证——这不算“跳过”,只是让中间件逻辑不拦截,但中间件本身仍被调用、仍消耗 CPU 和栈空间。真正该做的是:不要把不需要认证的路由放进这个全局链里。
- 登录、健康检查、静态资源等接口,应放在独立分组(
e.Group(""))或根路由下,不走e.Use()链 - 全局中间件里做路径判断耦合严重,未来改路由名、加 query 参数、重定向都会出错
- 若真需动态控制(极少数场景),可用
c.Get("skip_auth")+ 提前在 handler 里c.Set("skip_auth", true),但这破坏中间件职责单一性
全局中间件的典型组合顺序
洋葱模型决定顺序不能乱。例如日志、恢复、限流、鉴权这四类,推荐这样注册:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
e.Use(middleware.Recover())—— 最外层兜底,捕获 panic -
e.Use(middleware.RateLimiter(...))—— 在鉴权前限流,防爆破 -
e.Use(apiKeyMiddleware)—— 密钥校验必须在c.Next()前完成并 abort -
e.Use(middleware.Logger())—— 放最后,确保日志能记录最终状态码和耗时
如果把 Logger() 放最前,而中间件中途 Abort() 或 panic,日志就打不出来。
别忽略 Pre() 和 Use() 的分工
e.Pre() 不是“前置中间件”,而是专门处理重定向、协议升级等需要在路由解析前干预的场景。比如强制 HTTPS:
e.Pre(middleware.HTTPSRedirect())
它不接收 echo.Context,也不参与洋葱模型,和 e.Use() 完全正交。混淆这两者会导致中间件不执行或执行时机错乱——比如把 JWT 校验塞进 Pre(),c.Request().Header 可能还没完全初始化。


















