Beego中鉴权必须用beego.InsertFilter()注册过滤器,因无Use()/UseMiddleware()接口;拦截/static/资源须用BeforeStatic阶段,因静态请求绕过路由,BeforeRouter和BeforeExec均无效。

Beego 没有传统意义上的中间件,鉴权必须用 beego.InsertFilter() 注册过滤器,并严格匹配执行阶段 —— 写在 BeforeRouter 里拦不住 /static/,写在 BeforeExec 里又拿不到未解析的 URL 参数。
为什么 beego.Use() 和 UseMiddleware() 根本不生效
Beego 2.x(包括当前最新版 2.3.5)压根没实现 Use() 或 UseMiddleware() 这类 Express/Connect 风格的链式中间件接口。所有“中间件”本质是过滤器函数,注册入口唯一:beego.InsertFilter()。调用它之前没做任何封装,也没有中间件栈抽象。你看到的教程里出现这两个函数,基本是混淆了 Gin、Echo 或旧版 Beego 1.x 的 API。
- 试图在
main()里调beego.Use(...)→ 编译失败,undefined: beego.Use - 在 Controller 里调
this.Use(...)→ 方法不存在,IDE 直接报红 - 查源码发现
server/web/filter.go只导出InsertFilter和FilterFunc类型,无其他注册入口
BeforeStatic 是唯一能拦截静态资源的阶段
如果你的权限规则要覆盖 /static/admin/secret.pdf 或 /public/uploads/user-123.png,必须用 beego.BeforeStatic。因为 Beego 对 /static/ 路径做了短路处理:请求根本不会进路由匹配,BeforeRouter 和 BeforeExec 完全不触发。
-
ctx.Input.Param(":id")在BeforeStatic阶段返回空字符串 —— 参数解析还没开始,得自己用正则从ctx.Request.URL.Path提取 -
ctx.Controller、ctx.Input.Crued()等字段为 nil,直接访问会 panic - 校验通过后必须显式调用
ctx.Next(),否则静态文件也不会返回(Beego 不自动 fallback) - 示例片段:
func StaticAuthFilter(ctx *context.Context) { path := ctx.Request.URL.Path if strings.HasPrefix(path, "/static/admin/") { token := ctx.Input.Header.Get("Authorization") if !isValidToken(token) { ctx.Abort(403, "Forbidden") return } } ctx.Next() }
JWT 鉴权必须绕过 jwt.Parse,强制用 ParseWithClaims
Beego 不提供 JWT 封装,你得自己集成 github.com/golang-jwt/jwt/v5。但直接套用网上示例极易被 alg=none 攻击绕过验签 —— 因为 jwt.Parse 默认接受任意算法,而 Beego 的 Prepare() 或过滤器里没地方 hook 算法协商逻辑。
- 永远用
jwt.ParseWithClaims(tokenStr, &MyClaims{}, func(t *jwt.Token) (interface{}, error) { return []byte(secret), nil }) - 禁止在回调函数里动态判断
t.Method.Alg()后返回不同密钥 —— Beego 的并发模型下容易导致密钥泄露或类型 panic - Token 必须从
Authorization: Bearer xxx提取,ctx.Input.Header.Get("Authorization")返回的是完整字符串,需strings.TrimPrefix(val, "Bearer ") - 验签成功后,别只调
claims.Valid()—— 还要手动比对claims.Issuer == "my-service"和claims.Audience[0] == "api"
微服务透传 JWT 时,this.Ctx.Request 是只读副本
当 Beego 服务 A 接收带 JWT 的请求,再用 http.Client 调用服务 B 时,很多人习惯在 Controller 里写 this.Ctx.Request.Header.Set("Authorization", ...)。这完全无效 —— this.Ctx.Request 是只读快照,修改 Header 不影响后续外发请求。
- 正确做法:在构造
http.NewRequest时,把 Token 注入新请求的 Header:req, _ := http.NewRequest("GET", url, nil); req.Header.Set("Authorization", "Bearer "+token) - 如果下游是 gRPC,不能传原始 JWT 字符串,应提取
claims.Subject和claims["roles"],写入metadata.MD{"user-id": claims.Subject, "roles": rolesStr} - Beego 的
http.Client默认不复用连接,高频调用需手动配置http.Transport复用 TCP 连接,否则容易耗尽文件描述符
最常被忽略的一点:所有过滤器注册必须在 beego.Run() 之前完成,且 InsertFilter 的 pattern 参数不支持通配符以外的正则(比如 /api/v\d+/.* 会被忽略),真要按版本路由鉴权,得用 beego.NewNamespace() 配合 NSFilter()。











