Echo中间件顺序必须在启动时通过Use()或group.Use()固定，无法动态修改；Pre()仅用于路径标准化等无上下文操作，不可用于鉴权；条件逻辑应在中间件内部实现而非调整注册顺序。
中间件顺序不能“动态修改”，只能靠注册时的 Use() 顺序决定
Echo 没有运行时调整中间件顺序的 API，Use() 调用一旦完成，链就固定了。所谓“动态修改”，实际是误读——你无法在请求中、或启动后调用某个方法把日志中间件插到鉴权前面。所有顺序必须在 e.Use() 或 group.Use() 阶段写死。
常见错误现象：试图在 handler 里调 e.Use(authMw) 期望补注册，结果无效；或者用反射重排中间件切片，导致 panic 或行为不可预测。
- 全局中间件（
e.Use()）永远最先执行（请求进入时）和最后执行（响应返回时） -
路由组中间件（
group.Use()）只作用于该组路径前缀，但它在洋葱模型中的插入点是固定的：紧接在全局中间件之后、该组内路由匹配之前 - 单个路由附加的中间件（如
group.GET("/x", h, mw)）会追加在该路由对应组中间件之后，但仅对该路由生效
Pre() 和 Use() 的分工必须分清
Pre() 是唯一能“在路由前”运行的机制，但它不能访问 echo.Context，也不能调 c.Response() 或 c.JSON() —— 因为此时路由还没匹配，Context 都没初始化好。
典型用途只有三类：AddTrailingSlash、RemoveTrailingSlash、MethodOverride。如果你试图在 Pre() 里做 JWT 解析或权限检查，会直接 panic，报错类似 context canceled 或 nil pointer dereference。
- 需要读请求头、解析 token、查用户信息？必须用
Use()，且确保它注册在所有可能 Abort() 的中间件之前 - 想统一处理路径标准化（比如强制 /admin/users/ → /admin/users）？用
Pre()，别塞进Use()增加无谓开销 -
Pre()中间件不参与洋葱返回阶段，它只在请求进入时跑一次
真要“按需启用”中间件，得靠条件逻辑而非顺序调整
比如某些接口要鉴权，某些不要；某些路径走限流，某些跳过——这不是改顺序的问题，而是控制中间件内部是否执行关键逻辑。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
正确做法是在中间件函数里做路径/方法判断，而不是注册一堆中间件再想办法开关它们：
func conditionalAuth(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
path := c.Request().URL.Path
method := c.Request().Method
// 白名单：/health /login 不校验
if path == "/health" || (method == "POST" && path == "/login") {
return next(c)
}
// 其他路径走标准鉴权
token := c.Request().Header.Get("Authorization")
if !isValidToken(token) {
return c.NoContent(http.StatusUnauthorized)
}
return next(c)
}
}
- 避免用
if path == ... { e.Use(mw) }这类写法——e.Use()是启动期行为，不能放循环或条件分支里反复调 - 路径匹配注意标准化：
/users/和/users可能被不同中间件处理，建议统一用AddTrailingSlash或RemoveTrailingSlash预处理 - 如果条件逻辑复杂（比如基于用户角色动态开关），把判断抽成独立函数，别让中间件主体臃肿
Casbin 或自定义策略加载时机容易被忽略
用 Casbin 做动态权限时，很多人把 enforcer.Enforce() 直接写在中间件里，却忘了 enforcer 必须是单例，且策略要在启动时加载完成。否则每次请求都新建 enforcer 或重新加载策略，性能暴跌，还可能因并发读写出错。
正确姿势是：在 main() 初始化时构建并复用 enforcer，中间件里只调 Enforce()：
var enforcer *casbin.Enforcer
func initEnforcer() {
e, _ := casbin.NewEnforcer("model.conf", "policy.csv")
enforcer = e
}
func authzMiddleware(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
sub := getUserID(c) // 如从 JWT claims 提取
obj := c.Request().Method + " " + c.Request().URL.Path
act := "access"
if !enforcer.Enforce(sub, obj, act) {
return c.NoContent(http.StatusForbidden)
}
return next(c)
}
}
这个环节最容易漏掉的是策略热更新支持——如果权限配置变了，你得手动调 enforcer.LoadPolicy()，而不是指望中间件自己感知变化。
