单个路由中间件通过在 e.GET、e.POST 等方法末尾直接传入中间件函数实现，仅作用于该路由；需确保类型为 echo.MiddlewareFunc，且中间件内必须调用 next(c) 并 return，否则链路中断。
单个路由中间件怎么加，不是全局或分组的
直接在 e.GET、e.POST 等方法末尾追加中间件函数即可，它只作用于该条路由，不污染其他路径。
常见错误是误用 e.Use() —— 那是全局中间件，加了就全路由此起效；或者把中间件写成闭包但没调用，结果中间件根本没注册。
-
e.GET("/admin", handler, authMiddleware)：正确，第三个参数就是中间件 -
e.GET("/admin", handler, authMiddleware())：错误，authMiddleware()是调用后返回中间件函数，但这里多套了一层括号，实际传的是echo.HandlerFunc而非echo.MiddlewareFunc -
e.GET("/admin", handler, loggerMiddleware)和e.Use(loggerMiddleware)效果不同：前者只打这一条请求的日志，后者所有请求都打
中间件函数签名必须匹配 echo.MiddlewareFunc
单路由中间件要求类型是 echo.MiddlewareFunc，即 func(echo.Context) error 的包装器。如果你写的是裸的 func(echo.Context) error，会编译报错：cannot use xxx (type echo.HandlerFunc) as type echo.MiddlewareFunc。
解决办法只有两种：
- 用标准写法：写成闭包返回
echo.HandlerFunc，再包一层符合echo.MiddlewareFunc类型（推荐） - 或显式转换：
echo.MiddlewareFunc(yourHandlerFunc)，但可读性差，容易出错
示例（正确）：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func adminOnly(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
role := c.Get("role").(string)
if role != "admin" {
return c.NoContent(403)
}
return next(c)
}
}
// 使用时：
e.GET("/settings", settingsHandler, adminOnly)
多个中间件怎么按顺序执行
单路由支持传入多个中间件，按从左到右顺序执行，就像洋葱皮一层层包住 handler。第一个中间件最先拿到请求，最后一个中间件最接近 handler。
-
e.GET("/api/data", h, m1, m2, m3)→ 执行顺序：m1 → m2 → m3 → h - 每个中间件都必须显式调用
next(c)才会继续向下流转；不调就中断，后续中间件和 handler 都不会执行 - 注意中间件之间不能共享局部变量，如需传递数据，用
c.Set("key", value)+c.Get("key") - 若某个中间件提前返回 error（如
c.JSON(401, ...)），整个链路立即终止，响应直接发出，后面的中间件和 handler 不再运行
为什么有些中间件在单路由上不生效
最常被忽略的是中间件内部没调用 next(c)，或者调用了但没 return，导致 handler 被跳过。另一个隐蔽问题是中间件依赖上下文状态（比如认证信息），但该状态是在更外层中间件（如全局 JWT 解析）里设置的 —— 单路由中间件无法“看到”那些未执行的前置逻辑。
- 检查是否漏写
return next(c)（不是next(c)） - 确认该中间件是否依赖
c.Get("user_id")这类值，而这个值是否由全局中间件注入；如果不是，单路由中间件里就要自己解析 token 或查 DB - 调试技巧：在中间件开头加
log.Printf("in %s", "adminOnly")，看日志有没有打出，快速定位是否进入
单路由中间件看似简单，但真正难的是厘清执行时机和上下文依赖关系 —— 它不自动继承全局中间件的副作用，得自己补全链路。
