Echo不支持在路由组内排除中间件,推荐按语义拆分独立Group并分别注册中间件;若必须混用,需前置自定义跳过中间件并在JWT中间件中检查skip_jwt标记,同时显式处理OPTIONS预检请求。

不能在已注册中间件的路由组里“排除”某个中间件——Echo 没有 skipMiddleware 或 exclude 这类机制。你真正能做的,是绕过它、提前终止它,或从设计上避免它被挂到不该挂的地方。
用 Group 拆分路由是最干净的解法
绝大多数所谓“组内排除”,其实是误判了路由组织方式。Echo 的 e.Group() 本就支持按前缀隔离中间件,根本不需要在同一个组里做排除逻辑。
- 把需要 JWT 的接口全放进
auth := e.Group("/api"),再调用auth.Use(jwt.Middleware(...)) - 把不需要鉴权的接口(如
/login、/health、/public/*)放到另一个public := e.Group("")或e.Group("/v1")下,不注册任何 JWT 中间件 - 两个组完全独立,路径不重叠,中间件零交叉 —— 这比在中间件里写一堆
if path == "/login"安全十倍
必须混用时:用 context.Set("skip_jwt", true) 主动跳过
如果你真的无法拆分路由组(比如老系统强耦合、第三方 SDK 强制要求所有路由挂同一组),那只能自定义一层 wrapper,让官方 jwt.Middleware 看到标记后直接放行。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 自定义中间件必须放在
jwt.Middleware之前,例如:e.Use(skipJwtMiddleware)→e.Use(jwt.Middleware(...)) - 在
skipJwtMiddleware里判断路径或方法,匹配到就调用c.Set("skip_jwt", true) - 再封装一层
jwt.Middleware,在ExtractToken后检查c.Get("skip_jwt") != nil,成立则直接return next(c) - ⚠️ 切勿在中间件里直接
return nil或裸调next(c),会跳过后续所有中间件(CORS、日志、recover 都失效)
OPTIONS 预检请求经常被忽略
哪怕你写了白名单逻辑,OPTIONS 请求也大概率会卡在 JWT 校验环节,返回 401,导致前端跨域失败。
- 预检请求没有
Authorization头,JWT 中间件默认拒绝 - 正确做法是在自定义跳过逻辑里明确包含:
if c.Request().Method == "OPTIONS" { c.Set("skip_jwt", true); return next(c) } - 或者更早注册一个专门处理预检的中间件:
e.OPTIONS("/*", func(c echo.Context) error { return c.NoContent(204) }),并确保它在 JWT 之前执行
真正难的不是写跳过逻辑,而是想清楚:这个“排除”是不是暴露了路由结构不合理?很多团队后期重构时才发现,当初硬塞进一个组的接口,其实天然属于不同语义层级——拆开反而让权限、监控、部署都更清晰。


















