Revel的“自定义过滤器”是需手动调用下一节点的显式递归函数,必须按数据生命周期(如SessionFilter后才能读c.Session)插入全局Filters链,且动态配置须通过FilterConfiguringFilter在init()中声明。

Revel 的“自定义过滤器”不是插件式扩展,而是直接参与请求处理链的函数;所谓“深层 Web 数据过滤”,实际就是控制 Filter 在 revel.Filters 链中的位置和执行时机——顺序错了,c.Params 可能还没解析,c.Session 可能还没恢复,你的逻辑就提前读了空值。
定义符合签名的 Filter 函数
Revel 要求过滤器必须是 func(c *revel.Controller, fc []revel.Filter) 类型。它不是中间件注册表里的“钩子”,而是一个需手动调用下一个过滤器的显式递归节点。
常见错误现象:
- 忘记调用
fc[0](c, fc[1:]),导致后续过滤器(包括RouterFilter和ActionInvoker)完全不执行,请求卡死或 404 - 在调用前修改
c.Params,但ParamsFilter尚未运行 → 此时c.Params是空的,改了也白改 - 试图从
c断言具体控制器类型(如*AppController),但Filter接收的是泛型*revel.Controller,强制类型断言会 panic
正确写法示例:
var AuthFilter = func(c *revel.Controller, fc []revel.Filter) {
// 只有 SessionFilter 运行后,c.Session 才可用
if c.Session == nil || c.Session.Get("user_id") == nil {
c.Result = c.Redirect("/login")
return
}
// 必须显式推进链
fc[0](c, fc[1:])
}
插入到全局过滤器链:revel.Filters 修改时机
全局过滤器链在 app/init.go 的 init() 函数中初始化。你不能在 run() 或路由 handler 里改它——那时链已固化,改了也无效。
关键点:
- 必须在
revel.Filters = []revel.Filter{...}赋值前插入自定义过滤器,否则会被覆盖 - 顺序决定数据可用性:想读 session?确保
AuthFilter放在SessionFilter之后;想记录请求耗时?放在最外层(如PanicFilter前)更安全 - 不要删掉
ActionInvoker—— 它是最终调用 controller 方法的唯一出口,删了等于没路由
典型配置片段:
func init() {
revel.Filters = []revel.Filter{
revel.PanicFilter,
revel.RouterFilter,
revel.FilterConfiguringFilter,
revel.ParamsFilter,
revel.SessionFilter,
revel.FlashFilter,
AuthFilter, // ← 插在这里,SessionFilter 之后、ActionInvoker 之前
revel.InterceptorFilter,
revel.ActionInvoker,
}
}
按 Action 动态增删过滤器:FilterConfiguringFilter 的真实用法
这个过滤器本身不做业务,只负责在进入具体 action 前动态调整当前请求的过滤器链。它依赖 FilterAction 或 FilterController 等 DSL,但 DSL 不是魔法——它只是往一个 map 里塞规则,由 FilterConfiguringFilter 在运行时查表并 patch 当前链。
使用场景:
- 仅对
App.Login开放CORSFilter,其他接口禁止 - 给
Admin.*控制器批量加RoleCheckFilter,避免每个方法重复写权限逻辑 - 测试时临时禁用
SessionFilter,绕过登录态校验
注意坑:
-
FilterAction(App.Login).Add(CORSFilter)不会改变全局revel.Filters,只影响该 action 的本次请求链 - 如果在
FilterConfiguringFilter之前就用了自定义过滤器(比如插在RouterFilter后),它收不到配置指令——因为配置逻辑还没跑 - 所有动态操作必须在
init()中声明,不能 runtime 注册
“深层过滤”的实质:数据生命周期与链位置强绑定
Revel 没有抽象的“数据过滤层”,只有明确的、线性的过滤器执行序列。所谓“深层”,指的是你能否在正确的时间点访问到特定数据:
-
c.Params由ParamsFilter填充,此前为空 -
c.Session由SessionFilter恢复,此前为 nil -
c.Validation.Errors由ValidationFilter加载,此前无上下文
如果你的过滤器需要同时读 session 和 params,就必须插在两者之后;如果还想在 response 写 header,就得保证自己在 ActionInvoker 之后(即用 defer 或链尾追加)。没有“after”钩子,只有靠位置和手动控制 flow —— 这是 Revel 过滤器机制最易被忽略的约束。











