Beego中间件默认不拦截/static/请求,因静态资源由内置处理器直连磁盘响应,绕过BeforeRouter等全部路由阶段;必须用beego.BeforeStatic注册过滤器才能拦截,且需手动解析路径、避免使用未初始化的ctx字段。

Beego 中间件为什么默认不拦截 /static/ 请求
因为 Beego 的静态资源处理是独立于路由系统的:所有匹配 /static/ 前缀的请求,会直接由内置静态处理器接管,跳过 BeforeRouter、BeforeExec 等全部中间件阶段。你在 beego.InsertFilter("/*", beego.BeforeRouter, ...) 里写的逻辑,对 /static/js/app.js 完全无效——这不是 bug,是设计如此。
必须用 beego.BeforeStatic 拦截静态资源
这是唯一能干预静态文件请求的过滤点。注册方式和其他 filter 一样,但路径必须精确匹配或带正则:
-
beego.InsertFilter("/static/public/", beego.BeforeStatic, allowPublic)—— 只放行公开目录 -
beego.InsertFilter("/static/users/:id([0-9]+)/private/*", beego.BeforeStatic, authCheckForStatic)—— 匹配/static/users/123/private/report.pdf,末尾/*才能捕获子路径 - 别在
BeforeStatic里调ctx.Input.Param(":id"),参数没解析,得自己从ctx.Request.URL.Path里用正则提取 -
ctx.Data、ctx.Controller等字段为空,只能操作ctx.Ctx.Request和ctx.Ctx.ResponseWriter
如何让中间件「排除」某些静态路径而不做处理
所谓“排除”,其实是「不执行权限逻辑,直接放行」。常见做法是在 BeforeStatic 函数开头加白名单判断:
- 检查
ctx.Request.URL.Path是否以/static/assets/或/static/images/开头 - 匹配则直接调用
ctx.Next(),不 abort、不写响应 - 不匹配才走鉴权逻辑(比如查 session、校验 token)
- 注意:不能用
return跳出函数,否则静态处理器不会执行,请求就卡死了
混淆点:别把 BeforeStatic 和 BeforeRouter 搞混
一个典型错误是同时在两个阶段注册同一套权限中间件,以为能“覆盖所有路径”。结果是:
-
/api/login走BeforeRouter→ 正常鉴权 -
/static/private/file.pdf完全不进BeforeRouter→ 鉴权逻辑失效 - 但如果你只在
BeforeStatic注册,又忘了处理/api/→ API 请求没鉴权 - 结论:API 和静态资源权限必须分开写两套逻辑,分别注册到
BeforeRouter和BeforeStatic
最易被忽略的是:静态资源路径的权限校验无法复用 controller 层的 session 或 ORM 实例,所有依赖都得在 BeforeStatic 函数内手动初始化,且不能 panic。











