Beego中间件无法条件跳过,只能通过注册路径匹配(如"/api/")和阶段选择(BeforeExec等)控制生效范围,静态资源和OPTIONS请求默认绕过Filter链。

Beego 中间件无法“跳过”,只能控制注册时机和路径匹配
Beego 没有类似 Express 的 next() 跳过单个中间件、或 Gin 的 c.Next() 条件性执行机制。所谓“跳过”,本质是避免它被调用——要么不注册,要么让它不命中。
常见误操作是写一个中间件函数,在里面用 if 判断路径或方法后直接 return,这看似跳过,实则危险:此时 ctx.Next() 已部分执行,后续 Filter 或 Controller 可能状态异常;更严重的是,beego.BeforeStatic 阶段的中间件里 return 后,静态文件仍会被原样返回,权限形同虚设。
- 真正可控的方式只有两种:
beego.InsertFilter()的pattern参数(路径前缀匹配)和postion参数(阶段选择) - 想让某个中间件只对
/api/生效?注册时写beego.InsertFilter("/api/", beego.BeforeExec, myFilter),别写"*"或"/" - 想排除
/health和/metrics?不要在中间件里if path == "/health" { return },而是拆成两个注册:一个针对/api/,一个单独为/health写空逻辑或绕过注册
如何让中间件对特定路径“不生效”
路径匹配是 Beego 过滤器生效的唯一开关。它不支持黑名单(如“除 /health 外全部拦截”),只支持白名单前缀匹配,且结尾斜杠影响极大。
-
"/api"会错误匹配/apixxx、/apiary—— 因为它是子串匹配,不是路径前缀 -
"/api/"才安全,它只匹配/api/、/api/v1/、/api/users/123等真实 API 路径 - 想覆盖多个不连续路径?必须多次调用
beego.InsertFilter(),例如:beego.InsertFilter("/admin/", ...)和beego.InsertFilter("/api/", ...) - 静态资源路径(
/static/)永远不走BeforeRouter或BeforeExec,所以在这俩阶段注册的中间件对它天然“跳过”——但这不是你控制的,是框架设计
OPTIONS 预检请求为什么“跳过”所有中间件
这不是 bug,是 Beego 的硬编码行为:所有 OPTIONS 请求默认绕过全部 Filter 链,直接返回 204 No Content。这是为了兼容 CORS 预检,但代价是无法在预检中做鉴权或日志。
- 如果你需要拦截 OPTIONS(比如强制加 header 或记录来源),必须手动注册一个
beego.Any("/.*", optionsHandler),且放在beego.Run()前 -
optionsHandler是裸函数签名func(*context.Context),不是 Controller 方法,不能用this.Data等字段 - 注意:该 handler 会覆盖默认预检响应,需手动设置
Access-Control-Allow-Methods等 header,否则前端 CORS 仍失败
beego.InsertFilter 的 skip 参数几乎没用
文档里提到的 skip bool 参数(第四个可选参数)意思是“当已有输出时是否跳过此 Filter”。但它依赖 ctx.ResponseWriter.Written() 判断,而 Beego 中绝大多数中间件都在响应写出前执行,实际几乎不会触发跳过逻辑。
- 这个参数对日志类中间件可能有点用(比如已写 body 就不再打访问日志),但对权限、鉴权、body 解析类中间件完全无效
- 别指望靠它实现条件跳过;它不是设计来解决“哪些请求该进、哪些不该进”的问题
- 真正该关注的是:注册位置(
BeforeExecvsBeforeStatic)、路径 pattern(/api/vs/)、以及是否在beego.Run()前完成注册
最易被忽略的一点:Beego 的路径匹配发生在路由解析之前,而 ctx.Input.Param() 等参数解析发生在 BeforeExec 阶段之后。这意味着你在 BeforeRouter 或 BeforeStatic 里拿到的 ctx.Request.URL.Path 是原始未清洗的,可能带重复斜杠、大小写混杂、甚至恶意编码——权限校验若直接拿它比对,容易被绕过。


















