Beego Filter中断请求必须用ctx.AbortWithStatusJSON(),它自动设置状态码、Content-Type并写入JSON响应体;ctx.Abort()仅终止流程但不写响应,导致前端收到空响应。

Beego Filter 中断请求必须用 ctx.AbortWithStatusJSON(),不是 ctx.Abort()
直接调 ctx.Abort(401) 只会终止后续 Filter 和 Controller 执行,但不会写任何响应体,前端收到的是空响应(HTTP 状态码可能也不生效)。真正完成“中断 + 返回”动作,必须用 ctx.AbortWithStatusJSON()。
这个函数内部已自动调用 WriteHeader() 和 json.Marshal(),你只需传入状态码和 map 或 struct:
func authFilter(ctx *context.Context) {
token := ctx.Input.Header("Authorization")
if token == "" {
ctx.AbortWithStatusJSON(401, map[string]string{"error": "missing token"})
return
}
// 继续执行
ctx.Next()
}
-
AbortWithStatusJSON()会设置Content-Type: application/json,无需手动设 - 如需自定义 Header(比如
X-RateLimit-Remaining),必须在调用它之前写:ctx.ResponseWriter.Header().Set("X-RateLimit-Remaining", "0") - 不要在
AbortWithStatusJSON()后再调ctx.ServeJSON()或ctx.Render(),会 panic:response 已写出
为什么 ctx.Redirect() 在 Filter 里不推荐?
Filter 是请求处理管道中的一个环节,ctx.Redirect() 本质是发 302 响应并设 Location Header,但它不终止流程——调完后仍会继续执行 ctx.Next(),可能导致重复写响应或 panic。
正确做法是显式终止:
- 要跳转,用
ctx.Redirect(302, "/login")+return(注意:它不自动 abort) - 更稳妥的是组合使用:
ctx.ResponseWriter.Header().Set("Location", "/login"); ctx.ResponseWriter.WriteHeader(302); return - 若需带 JSON body 的跳转(少见),只能手写响应,
Redirect()不支持
OPTIONS 预检请求默认不走 Filter,怎么拦?
Beego 默认跳过所有 Filter 对 OPTIONS 请求的执行——这不是 bug,是设计行为。所以即使你在 /api/* 注册了鉴权 Filter,预检请求也完全绕过,后端 CORS 头可能没加,导致浏览器报错 “CORS header ‘Access-Control-Allow-Origin’ missing”。
解决方式只有两个:
- 在 Filter 函数开头手动判断:
if ctx.Ctx.Request.Method == "OPTIONS" { ctx.AbortWithStatusJSON(200, nil); return } - 或者更彻底:注册一个专用的 OPTIONS 处理器,在路由中显式匹配:
beego.Router("/api/*", &ApiController{}, "options:OptionsHandler"),然后在 Controller 里统一返回 CORS 头 - 注意:不能依赖 Beego 的
Cors插件自动补头,它只对非-OPTIONS 请求生效
Filter 中提前响应后,Controller 还会执行吗?
不会。ctx.AbortWithStatusJSON() 或 ctx.Abort() 会立即跳出当前 Filter,并阻止所有后续 Filter 和目标 Controller 的执行。但要注意一个边界情况:
- 如果该 Filter 是注册在
beego.BeforeExec阶段,而你又在其中调了ctx.Input.ParseForm(),那即使 abort,ParseForm()已经消费了Request.Body,后续其他 Filter(比如日志)若再读 body 就会得到空内容 - 在
BeforeRouter阶段 abort 是最干净的,此时连路由都没开始匹配,body 未被读取 - 别在 abort 后还试图访问
ctx.Input.Param(":id")—— 它在BeforeExec之前不可用,会返回空字符串
实际项目中最容易忽略的是:**Filter 注册顺序 + 阶段选择 + OPTIONS 特殊处理这三者的组合影响**。比如你把鉴权 Filter 放在 BeforeExec,又忘了处理 OPTIONS,再配上 CORS 配置缺失,前端就卡在预检失败,而日志里却看不到任何 Filter 执行痕迹。











