beego自定义过滤器必须在main.go的init()或main()函数中、beego.run()前注册；函数签名固定为func(*context.context)，需用ctx.abort()终止流程；按注册顺序执行，路径匹配遵循模式优先级。
Beego 中自定义过滤器的注册位置在哪
Beego 的自定义过滤器必须在 main.go 的 init() 或 main() 函数中、调用 beego.Run() 之前注册，否则不会生效。常见错误是把过滤器定义写在 controller 文件里，或者注册晚于 beego.Run() —— 这时框架已启动 HTTP 服务，过滤器根本不会被加载。
正确做法是统一在 main.go 顶部注册，例如：
func init() {
beego.InsertFilter("/api/*", beego.BeeApp.Handlers, authFilter, true)
}
其中第三个参数是过滤器函数，第四个参数 true 表示该过滤器作用于匹配路径的所有子路径（即开启通配递归）。
如何编写符合 Beego 签名的过滤器函数
Beego 过滤器函数签名固定为 func(*context.Context)，不能带返回值，也不能用 error 类型传递失败逻辑。所有控制流（如跳转、中断、设置状态码）都必须通过操作 ctx 完成。
典型错误包括：在过滤器里直接 return 而不调用 ctx.Abort()，或误用 ctx.Redirect() 后未终止执行，导致后续 handler 仍被执行。
一个基础鉴权过滤器示例：
func authFilter(ctx *context.Context) {
token := ctx.Input.Header("Authorization")
if token == "" {
ctx.Abort(401, "Unauthorized")
return
}
if !isValidToken(token) {
ctx.Abort(403, "Forbidden")
return
}
}
注意：ctx.Abort() 是关键，它会立即终止当前请求链，不进入 controller；漏掉 return 可能引发 panic 或重复响应。
过滤器执行顺序和嵌套路径匹配规则
Beego 按注册顺序依次执行过滤器，但路径匹配优先级由注册时的路径模式决定：/api/* 匹配 /api/user 和 /api/v2/order，而 /api/（无星号）只匹配字面量路径，不匹配子路径。
多个过滤器叠加时容易踩的坑：
-
InsertFilter()插入到 Beego 内置 handler 链的指定位置，beego.BeeApp.Handlers是默认中间件链；若想在路由解析前拦截，应选beego.BeforeRouter - 全局过滤器（如
/*）和局部过滤器（如/admin/*）同时存在时，两者都会触发，且全局的先执行 - 过滤器内修改
ctx.Input.Param()或ctx.Input.Data对后续 controller 可见，但修改ctx.Request.URL不影响路由匹配（路由已在前阶段完成）
调试过滤器不生效的三个检查点
当过滤器看似“没运行”，大概率不是语法问题，而是环境或配置疏漏：
- 确认
beego.Router()注册的路径与过滤器路径模式是否真正匹配（比如注册了/v1/user，但过滤器写了/api/*，就不会命中） - 检查 Beego 版本：v2.x 中
InsertFilter()的第二个参数必须是beego.BeeApp.Handlers或其他明确 handler 链标识符，旧版 v1.x 的beego.FILTER_BEFORE_ROUTER等常量在 v2 中已废弃 - 启用 Beego 日志级别为
LevelDebug，并在过滤器开头加beego.Debug("authFilter triggered for ", ctx.Request.URL.Path)，验证是否真没进、还是进了但逻辑提前退出
路径匹配和注册时机这两个点，占实际项目中过滤器失效原因的八成以上。写完别急着测接口，先盯一眼 main.go 里注册语句的位置和参数。
