Beego中间件需在beego.Run()前用InsertFilter()注册,分BeforeRouter/BeforeStatic/BeforeExec三阶段;路径须带结尾斜杠,静态资源仅BeforeStatic可拦截;必须调ctx.Next()或ctx.Abort(),避免N+1查询与重复DB请求。

Beego 的中间件(即过滤器)不是插件式挂载,而是靠 beego.InsertFilter() 在特定阶段注册函数;不卡准阶段、不写对路径匹配规则、不调用 ctx.Next(),权限逻辑就形同虚设。
beego.InsertFilter() 注册时机和阶段选错直接失效
所有过滤器必须在 beego.Run() 之前注册,通常放在 main() 开头或 init() 函数里。注册晚了等于没写。
-
beego.BeforeRouter:能拦截全部动态请求,但对/static/类路径完全无效——静态请求绕过整个路由系统 -
beego.BeforeStatic:唯一能拦/static/users/123/private.pdf这类请求的阶段,但此时ctx.Input.Param()不可用,得手动从ctx.Request.URL.Path提取参数 -
beego.BeforeExec:路由已匹配、ctx.Input.Param()和ctx.Input.RequestBody都就绪,适合做最终权限校验,但无法覆盖静态资源
路径匹配必须带结尾斜杠且避免误触发
想只拦截 API 请求,别用中间件里 if strings.HasPrefix(ctx.Request.URL.Path, "/api/") 判断后跳过——这会漏掉 beego.BeforeStatic 阶段,且破坏过滤器链语义。
- 正确写法:
beego.InsertFilter("/api/", beego.BeforeRouter, apiAuthFilter),结尾斜杠防止匹配到/apixxx - 静态资源限制要单独注册:
beego.InsertFilter("/static/users/", beego.BeforeStatic, staticAuthFilter) - 正则路径如
/static/users/:id([0-9]+)/private/*可用于更细粒度控制,但:id不能靠ctx.Input.Param()拿,得自己 parse
中间件函数里不调 ctx.Next() 就中断流程
Beego 过滤器不是回调,是同步控制流。忘记调 ctx.Next(),后续所有过滤器和 Controller 都不会执行;只写 return 更危险,它只退出当前函数,但请求还在继续往下走。
- 终止请求必须用
ctx.Abort(401, "Unauthorized")或ctx.Abort(403, "Forbidden"),不能只return - 不要
defer ctx.Next(),这不是 defer 场景,是明确的流程跳转 - POST 权限校验需先判断方法:
if ctx.Request.Method != "POST" { ctx.Next(); return },避免对 GET 调用ParseForm()导致 body 读取异常
权限校验性能陷阱:别让每次请求都查库
在 BeforeExec 或 BeforeStatic 里直接 ORM 关联查 Role → Permission,极易触发 N+1 或笛卡尔积查询,一次鉴权拉出 5~8 次 DB 请求。
- 推荐用
orm.Raw()写单条 SQL,只 SELECT 必需字段,WHERE 限定user_id和有效状态 - 若坚持 ORM,至少拆成两步:先查
role_id列表,再用In()批量查权限,不跨三张表 Join - 缓存 key 建议设为
"perm:uid_123",TTL 5~10 分钟,用应用内存比 Redis 更轻量 - 路径标准化要在 Filter 末尾统一做:去掉末尾斜杠、剥离
/v1/版本前缀,再映射为resource:action格式(如user:read)
最难的部分不是写 if-else,而是让权限校验在 3ms 内完成——阶段选错、路径没 parse 对、缓存没设、SQL 多查一列,任何一个点都会拖垮整条链路。











