路由组中间件必须用Party.Use()注册,不能依赖全局中间件;执行顺序为父→子、不可跳过;作用域严格限定于该分组,子分组不自动继承父中间件,需显式调用Use()追加。

路由组中间件必须用 Party.Use() 注册,不能靠全局中间件“覆盖”
在 app.Party("/admin") 创建的分组里加中间件,必须调用该分组实例的 Use() 方法。如果误用 app.Use() 或 app.UseGlobal(),中间件会作用于全部路由(包括非 admin 路径),失去分组隔离性。
-
admin := app.Party("/admin")后,中间件要写成admin.Use(authMiddleware) -
app.Use(authMiddleware)是全局生效,app.UseGlobal()优先级最高、最先执行,无法限定范围 - 若需某分组“跳过”某个全局中间件,只能在中间件内部做
ctx.Path()或ctx.GetCurrentRoute().Subdomain()判断,不能靠注册位置规避
Party.Use() 的执行顺序是父 → 子,且不可跳过
中间件按注册顺序叠加,不是“继承”也不是“覆盖”。比如 api.Party("/v1").Party("/users") 这条链上,api.Use(log) 和 v1.Use(auth) 都会执行,且 log 总在 auth 前运行。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 子分组调用
Use()不会屏蔽父分组已注册的中间件,只会追加到其后 - 没有类似 Express 的
next("route")跳过当前分组中间件的机制;想跳过,得在中间件函数里手动ctx.StopExecution()或条件返回 - 若某路由需要完全绕开某层中间件(比如健康检查接口不走 auth),应单独建一个无中间件的分组,如
health := app.Party("/health"),而非复用已有分组
中间件注册位置影响实际生效范围
同一个分组实例多次调用 Use(),中间件按调用顺序入队;但若在分组创建后、注册子分组前漏掉中间件,子分组将不会自动带上它——因为子分组是新 Party 实例,只继承路径拼接逻辑,不继承父分组中间件注册状态。
- 错误写法:
admin := app.Party("/admin"); users := admin.Party("/users"); admin.Use(auth)——auth仍生效,但顺序易被误判 - 推荐写法:先注册中间件,再创建子分组,逻辑更清晰:
admin := app.Party("/admin"); admin.Use(auth); users := admin.Party("/users") - 注意
Party.Done()是后置中间件(响应阶段执行),和Use()的前置行为不冲突,但同样遵循父子顺序
动态路径参数与中间件配合的常见坑
带通配符的路由(如 /users/{id:int})本身不影响中间件执行,但中间件里读取 ctx.Params().Get("id") 时,若未校验参数是否存在或类型是否匹配,容易 panic 或静默失败。
- 中间件中访问 URL 参数前,务必先调用
ctx.Params().Len() > 0或ctx.Params().GetString("id") != "" - 若中间件需根据参数做权限判断(如只允许操作自己的 profile),不要依赖前端传的
id,而应从 JWT 或 session 中提取用户标识再比对 -
ctx.Next()必须显式调用,否则后续中间件和 handler 不会执行;忘记写会导致整个链路卡死,仅返回空响应
Use(),但路径拼接、执行顺序、作用域边界这三者一旦错位,调试成本远高于平铺路由。最稳妥的做法是:每个分组创建后立即注册其专属中间件,并避免跨分组复用同一中间件实例(除非明确设计为无状态)。


















