Beego中间件拦截校验token需用beego.InsertFilter()注册路径前缀(如"/api/*"),从Header提取Bearer token,解析后调ctx.Input.SetData()注入用户信息,失败时用AbortWithStatusJSON()返回401。

Beego 中间件如何拦截并校验 token
Beego 的中间件本质是 func(http.Handler) http.Handler 类型的包装函数,但框架自身提供了更贴近 Web 框架语义的写法:用 beego.InsertFilter() 注册,配合 beego.Controller 的生命周期钩子(如 Prepare())做前置鉴权。关键不是“能不能”,而是“在哪做、怎么取、怎么退”。
常见错误现象包括:token 从 header 里没正确提取、鉴权失败后返回 200 + 错误页面(而不是 401)、或用户信息塞进 Controller.Data 后在后续 Action 里取不到。
- 必须在
beego.InsertFilter("/api/*", beego.BeeApp.Handlers, authMiddleware, true)中指定路径前缀,true表示启用自动匹配子路径;不加这个参数会导致 /api/v1/user 被跳过 - 不要在中间件里直接调用
c.Abort("401")—— 这是 Controller 方法,中间件拿不到c实例;正确做法是写入 response 并 return,例如:w.WriteHeader(401); w.Write([]byte(`{"code":401,"msg":"unauthorized"}`)) - 若使用 gtoken,它的
GetTokenData()需要传入r.Request和配置好的gtoken.GfToken实例,别漏掉初始化步骤
如何把登录用户 ID 塞进 Controller 上下文供后续 Action 使用
Beego 不像 Gin 那样有天然的 Context.WithValue() 链路,它靠的是 Controller.Ctx.Input.SetData() 和 Controller.Ctx.Input.GetData() 这对方法,在中间件中完成注入,才能在 Controller 的任意 Get()/Post() 方法里拿到。
容易踩的坑是:有人试图在中间件里写 c.Data["uid"] = uid,但这只是往模板渲染数据里塞,和请求上下文无关;还有人混淆了 c.Ctx.Input.Data(已废弃)和 c.Ctx.Input.SetData()(当前有效)。
- 在中间件函数体里,先用
gtoken.GetTokenData(r)解析出用户 ID,再通过r.Context().Value()或更稳妥的r.Header.Get("X-User-ID")回传(如果 gtoken 已设置 header) - 推荐统一用
c.Ctx.Input.SetData("account_id", accountId)注入,然后在 Controller 的Prepare()或具体 Action 里用c.Ctx.Input.GetData("account_id")取 - 注意类型断言:返回值是
interface{},需显式转成int64或string,否则运行时报 panic
为什么 Beego 的全局 Filter 容易漏掉静态资源和 Swagger 路由
Beego 默认把 /static/、/swagger/、/v1/docs 这类路径注册为静态路由或自动生成路由,它们绕过了你用 InsertFilter() 设置的 filter 链。结果就是:鉴权中间件对这些路径完全不生效,变成未授权访问的后门。
这不是 bug,是设计使然——Beego 认为这些路径不属于业务 API,所以不走标准 filter 流程。但微信小程序后端往往把接口文档也暴露在线上,必须堵住。
- 检查你的
routers/router.go,确认是否手动注册了beego.Router("/swagger/:id:int", &controllers.SwaggerController{}, "*:Swagger")这类路由;如果是,得单独给它加 filter:beego.InsertFilter("/swagger/*", beego.BeeApp.Handlers, authMiddleware) - 对
/static/路径,除非你真需要鉴权静态文件(比如权限控制的 JS bundle),否则建议直接禁用:beego.SetStaticPath("/static", ""),或改用 Nginx 层统一处理 - Beego v2 开始支持
beego.InsertFilterChain(),可定义 filter 执行顺序,但默认仍不覆盖静态路由,这点必须手动手动补全
gtoken 与 Beego 结合时 Redis 缓存失效的典型原因
你配了 gredis,但发现重启服务后 token 还是丢了,或者不同实例间登录态不共享——大概率是 Redis 地址、DB、密码没对齐,或 gtoken 初始化时机早于 Beego 配置加载。
gtoken 默认用内存缓存 gcache,一旦你显式调用了 gtoken.GfToken{...}.Start() 却没传 Store,它就退回到内存模式,跟 Redis 毫无关系。
- 确保在
main.go的init()或main()开头就初始化 gtoken 实例,并传入redis.NewStore(...),不要等到beego.Run()之后 - 检查
redis.NewStore()的addr是否带协议(应为"127.0.0.1:6379",不是"redis://127.0.0.1:6379"),gtoken 的 redis store 不认 URL 格式 - Beego 的
conf/app.conf里如果写了redis.addr = ...,gtoken 不会自动读——你得手动config.String("redis.addr")拿出来再构造 store
最常被忽略的一点:Beego 的 Prepare() 方法执行时机在所有 filter 之后,但如果你在 filter 里解析 token 失败却没终止请求,Prepare() 仍会执行,导致后续逻辑拿到空用户 ID 而不报错。务必在 filter 中彻底中断非法请求流。


















