revel-csrf包需执行go get github.com/cbonello/revel-csrf安装,并在app/init.go的init()中将csrf.CSRFFilter插入Filter链,位置必须在SessionFilter之后、ValidationFilter之前、ParamsFilter之后;前端须通过{{.csrf_token}}传入name="csrf_token"字段,且app.secret必须非空、固定、跨实例一致。

revel-csrf包怎么装和注册到Filter链
Revel 不自带 CSRF 中间件,必须用社区维护的 github.com/cbonello/revel-csrf。执行 go get github.com/cbonello/revel-csrf 后,在 app/init.go 的 init() 函数里把 csrf.CSRFFilter 插入 revel.Filters 数组——位置很关键:
- 必须在
revel.SessionFilter之后:否则读不到 session,csrf_token始终为空 - 必须在
revel.ValidationFilter之前:否则参数校验先跑完,CSRF 校验被跳过 - 绝对不能放在
revel.ParamsFilter前面:否则c.Params还没解析,取不到表单里的csrf_token字段
典型正确顺序(只列关键项):
revel.Filters = []revel.Filter{
revel.ParamsFilter,
revel.SessionFilter, // ← 必须已执行
revel.FlashFilter,
csrf.CSRFFilter, // ← 放这里
revel.ValidationFilter, // ← 必须还没执行
revel.ActionInvoker,
}
HTML表单和AJAX怎么传csrf_token
Revel 模板不自动注入 token,你得手动写、手动传,且大小写和字段名必须严格匹配:
- 模板中变量名只能是
{{.csrf_token}},不是{{.CSRFToken}}或{{.CsrfToken}} - 表单字段名必须是
name="csrf_token",不是name="token"或name="_csrf" - 每个 POST/PUT/DELETE 表单都得加:
- AJAX 提交时,要把
{{.csrf_token}}塞进请求体(不是 header),字段名仍为csrf_token - 如果 controller 没调
c.RenderArgs["csrf_token"] = csrf.Token(c),模板里{{.csrf_token}}就是空字符串
为什么403但token看起来是对的
最常被忽略的是 app.conf 里的
app.secret配置——它不是可选项,而是 CSRF token 签名密钥:
app.secret 必须是非空、固定、跨所有实例一致的字符串;开发时用默认值或空字符串,上线后负载均衡下 A 机器生成的 token 在 B 机器上会校验失败- 别用动态值(如
time.Now().String())初始化app.secret,会导致每次重启签名密钥变化 - token 有效期由
session.expires控制,不是 CSRF 包自己设的;改错地方会导致 token 过早失效 - CSRF token 绑定的是 session ID,不是用户 ID;用户登出后若没调
c.Session.Clear(),旧 token 仍能通过验证
生产环境session存储必须换掉
Revel 默认用内存存 session,c.Session 重启就丢,这直接导致 CSRF token 失效或校验错乱:
- 开发时可能没问题,一上生产(尤其多实例 + 负载均衡),token 存在 A 实例的内存里,请求打到 B 实例就查不到,必然 403
- 必须替换为 Redis 或数据库后端;
revel.SessionStore接口支持自定义实现,官方有revel-redis-session可直接集成 - 别试图用 Cookie 存完整 token——Revel 的 session 机制不支持双重提交 Cookie 模式,硬套会失效
- token 生成必须用
crypto/rand.Read生成至少 32 字节随机字节,再 base64 编码;用math/rand是不安全的
真正卡住人的从来不是“怎么加”,而是 token 生命周期、session 共享、签名密钥一致性这三处细节——漏一个,整个防护就形同虚设。











