Beego中间件（过滤器）不支持直接传参，因beego.InsertFilter仅接受func(*context.Context)签名；必须通过闭包捕获或读取app.conf等全局配置实现参数化。
Beego 的中间件（即过滤器）本身不接受参数配置，所有“配置”都得靠闭包捕获或从全局配置读取；硬塞参数进 beego.InsertFilter 会报错或静默失效。
为什么不能直接传参给 Filter 函数
Beego 的过滤器注册接口 beego.InsertFilter 只接受固定签名的函数：func(*context.Context)。它不支持带额外参数的函数类型，也不做闭包自动绑定。如果你写成 func(ctx *context.Context, timeout int) 或用 func(timeout int) FilterFunc 返回闭包但没正确调用，编译失败或运行时 panic 是大概率事件。
常见错误现象：
- 定义
func AuthFilter(timeout int) func(*context.Context)，却在InsertFilter里直接传AuthFilter(30)—— 实际上传的是函数值，不是调用结果 - 在
init()里调用AuthFilter(30)但忘了赋值给变量，导致闭包没被注册 - 把配置项写死在函数体里，改个超时时间就得重新编译
用 AppConfig 提取运行时配置
把参数挪到 conf/app.conf 里，用 beego.AppConfig 读取，是最稳妥、可热更新的方式。比如加一个登录态有效期控制：
在 app.conf 中写：
auth_session_timeout = 3600 auth_skip_paths = "/login,/static,/healthz"
然后在过滤器里解析：
func AuthFilter(ctx *context.Context) {
timeoutStr := beego.AppConfig.String("auth_session_timeout")
timeout, _ := strconv.Atoi(timeoutStr)
if timeout
<p>注意点：</p>
-
beego.AppConfig在beego.Run()前就已初始化，放心用 - 字符串切分后记得
strings.TrimSpace，否则空格会导致匹配失败 - 不要在过滤器里反复调用
AppConfig.String——它内部有缓存，但频繁解析仍是冗余
用闭包封装配置并正确注册
如果必须在代码里硬编码或动态生成参数（比如测试环境 mock），就用闭包，但必须确保注册时执行闭包得到最终函数：
func NewAuthFilter(timeout int, skipPaths []string) beego.FilterFunc {
return func(ctx *context.Context) {
path := ctx.Request.URL.Path
for _, p := range skipPaths {
if strings.HasPrefix(path, p) {
ctx.Next()
return
}
}
// 校验逻辑，用 timeout
}
}
// 正确注册方式（在 main() 或 init() 里）：
beego.InsertFilter("/.*", beego.BeforeExec, NewAuthFilter(1800, []string{"/public", "/assets"}))
容易踩的坑：
- 漏掉括号：写成
NewAuthFilter(1800, ...)是对的，写成NewAuthFilter就传错了类型 - 闭包捕获了未初始化的变量（比如在
init()里引用了还没 load 的 config），导致运行时报 nil panic - 把
skipPaths写成全局变量再修改，多个过滤器实例会互相污染
BeforeStatic 阶段无法用 Input.Param，得手动解析路径
如果你的中间件挂载在 beego.BeforeStatic（例如拦截 /static/private/xxx.pdf），ctx.Input.Param(":id") 一定为空——因为此时路由还没匹配，参数根本没解析。必须自己从 ctx.Request.URL.Path 里抠：
func StaticAuthFilter(ctx *context.Context) {
path := ctx.Request.URL.Path
// 匹配 /static/private/ 开头且含 UUID 的路径
re := regexp.MustCompile(`/static/private/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`)
if !re.MatchString(path) {
ctx.Abort(403, "Forbidden")
return
}
// 后续校验权限...
ctx.Next()
}
这个细节常被忽略：同一套鉴权逻辑若同时用于 BeforeExec 和 BeforeStatic，参数提取方式必须分支处理，不能复用同一段 Param 调用代码。
