Beego中间件必须显式挂载到指定位置才生效:/api/*仅匹配/api/开头路径,函数式路由(如beego.Get)完全绕过Filter链,NSFilter仅作用于本命名空间内路由,Prepare()仅为单控制器有效。

中间件挂载位置决定作用范围
Beego 的中间件不是全局自动生效的,必须显式挂到路由、命名空间或控制器生命周期钩子上。挂错地方,中间件就完全不执行。
-
beego.InsertFilter("/api/*", beego.BeeLogger.Info, logMiddleware):只对/api/开头的路径生效,*是通配符,匹配剩余路径(不含开头/) -
beego.InsertFilter("/*", beego.BeeLogger.Info, logMiddleware):理论上全站生效,但实际会漏掉函数式路由(如beego.Get()),因为后者不走 Filter 链 - 在命名空间里用
NSFilter:例如v1.NSFilter("*", authMiddleware),只作用于该命名空间内所有beego.Router注册的路由,不影响beego.Get或其他命名空间 - 控制器内写
Prepare():它本质是 per-controller 中间件,但只对本控制器有效,且无法提前终止请求(不像InsertFilter可以ctx.Abort())
函数式路由(beego.Get/Post)不触发任何 Filter
这是最常踩的坑:写了 beego.InsertFilter("/user/*", ...),又写了 beego.Get("/user/:id", handler),结果中间件完全没运行。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
beego.Get、beego.Post等绑定的是裸函数,绕过整个 Beego 的 Controller 生命周期,Filter、Prepare()、Finish()全部跳过 - 路径参数也拿不到:
beego.Get("/user/:id", ...)会直接 404;函数式路由只支持字面量路径,不支持:id这类动态段 - 若必须加中间件逻辑,只能手写在函数体内:
beego.Get("/health", func(c *context.Context) { authCheck(c); c.WriteString("ok") }) - 想统一鉴权?别用
beego.Get做业务接口,改用beego.Router+ Controller +NSFilter或全局InsertFilter
Filter 执行顺序和 Abort 行为
Filter 按注册顺序执行,但“before”和“after”阶段严格分离,且 Abort() 会立即跳出当前阶段,不执行后续 Filter 和 Controller 方法。
-
beego.InsertFilter("/api/*", beego.BeeLogger.Info, f1, true)中第三个参数true表示 “before router”,即在路由匹配后、Controller 实例化前执行;false是 “after router”,在 Controller 方法返回后执行 -
ctx.Abort(401)后,Controller 的Get()不会调用,但 “after router” 类型的 Filter 仍会执行(除非你也在里面Abort()) - 多个 Filter 共享
ctx.Input.Data,可用来传递数据,但注意并发安全 ——ctx是 per-request 的,无需额外锁 - 别在 Filter 里修改
ctx.Request.URL.Path,Beego 路由匹配已完成,改了也没用;真要重写路径,用ctx.Redirect()或ctx.ResponseWriter.WriteHeader()+ 手动输出
命名空间 Filter 与嵌套作用域
NSFilter 不继承、不穿透,每个命名空间的 Filter 是独立作用域,这点和直觉相反。
-
v1 := beego.NSNamespace("/api/v1", ...); v1.NSFilter("*", auth)→ 只对v1内部的NSRouter生效,v1.NSNamespace("/admin", ...)里的路由不会自动获得auth - 如果需要跨多级命名空间统一鉴权,必须在最外层命名空间挂 Filter,或每个子空间重复调用
NSFilter -
NSFilter的"*"匹配所有 HTTP 方法,但只限于当前命名空间注册的路由;它不会影响同路径下其他命名空间或全局beego.Router的行为 - 一个常见错误:把
beego.Router("/api/v1/users", &UserCtrl{})和beego.NSNamespace("/api/v1", ...)混用 —— 前者注册到全局路由表,后者注册到命名空间树,两者互不感知,容易导致重复路由或权限遗漏
beego.Get 根本不进 Filter 链,或者以为 NSFilter 会自动向下传递。路由方式选错,中间件就形同虚设。


















