Beego中间件必须通过web.InsertFilter显式注册才执行,函数签名固定为func(*web.Context),无返回值和next参数;中断靠c.Abort(401)或c.StopRun(),注册须在web.Run()前,路径匹配需注意通配精度与执行点选择。

web.InsertFilter 必须调用,不注册就完全不执行——Beego 中间件不是自动加载的插件,也没有装饰器或配置扫描机制。
中间件函数签名和中断方式
Beego 的 Filter 函数签名固定为 func(*web.Context),不能带返回值,也不接受 next 参数。是否终止后续流程,全靠显式调用 c.Abort() 或 c.StopRun():
-
c.Abort(401):立即终止,跳过所有后续 Filter 和 Controller,直接写出对应状态码响应 -
c.StopRun():终止但不写响应,适合重定向(需手动c.Redirect())或提前退出 - 漏掉
c.Abort()却又没让请求继续走?会导致重复写响应头、panic 或 500 错误
注册时机和路径匹配陷阱
注册必须在 web.Run() 之前,通常放在 main.go 的 init() 或 main() 开头;路径匹配规则容易出错:
-
/api/不匹配/api/users,得写成/api/*或正则/api/.* -
/*匹配所有路径,但会覆盖静态文件路由(如/static/xxx),若需排除,得单独注册更精确的路径 - 注册顺序 = 请求执行顺序,响应阶段逆序执行;比如两个
web.BeforeRouter,先注册的先执行
选对执行点:BeforeRouter vs AfterExec
高频且安全的两个钩子是 web.BeforeRouter 和 web.AfterExec,其他点(如 web.BeforeExec)介入太早,易踩坑:
-
web.BeforeRouter:请求刚进,还没做路由判断,适合全局鉴权、CORS 预检、日志起始计时 -
web.AfterExec:Controller 的Get/Post已执行完,响应数据已生成但未写出,适合加统一Header、记录耗时、清理临时资源 - 别用
web.BeforeExec做权限检查:此时this.Ctx.Input.Param可能为空,路由虽已匹配但参数未解析完成
在 Controller 里读取中间件数据
中间件设置的数据要传给 Controller,不能靠闭包或全局变量,得走 Beego 的上下文通道:
- 中间件中存:
c.Ctx.Input.SetData("user_id", 123) - Controller 中取:
c.Ctx.Input.GetData("user_id"),返回interface{},需类型断言 - 注意:SetData 是线程安全的,但只对当前请求生命周期有效;跨请求共享要用缓存或 DB
web.BeforeExec 里读不到参数,或在 web.AfterExec 里试图修改已写入的响应体。


















