Revel 框架默认不启用 CSRF 防护,需手动集成 revel-csrf 包并严格满足四个条件:Filter 顺序须在 SessionFilter 后、ActionInvoker 前;app.secret 必须非空且固定;模板中显式插入 csrf_token 字段;AJAX 提交必须将 token 放入请求体而非 header。

Revel 框架默认完全不启用 CSRF 防护,不是“关着的开关”,而是压根没装这个模块——不手动引入、不调整 Filter 顺序、不改模板,所有 POST/PUT/DELETE 请求都裸奔。
用 revel-csrf 包注册 Filter 是最简路径
别自己手写中间件,社区维护的 github.com/cbonello/revel-csrf 已覆盖 token 生成、session 绑定、恒定时间比对等细节。但必须严格满足三个条件才生效:
-
go get github.com/cbonello/revel-csrf后,在app/init.go的init()函数里把csrf.CSRFFilter插入revel.Filters列表 - 位置必须在
revel.SessionFilter之后、revel.ActionInvoker之前——漏掉前者导致 session 为空,放后者之后则跳过校验 -
app.conf中app.secret必须是非空、固定、跨实例一致的字符串;若为默认值或空,多实例下 token 签名无法互验,负载均衡时必 403
模板里必须显式写 csrf_token 字段
Revel 不会自动注入 token,也不支持 @csrf 这类语法糖。你得在 Controller 的 action 函数中提前把 token 注入 view:
- 调用
renderArgs["csrf_token"] = csrf.Token(c)(注意函数名是Token,不是GetToken或Generate) - HTML 表单里加:
<input type="hidden" name="csrf_token" value="{{ .csrf_token }}"> - AJAX 请求必须手动把
{{ .csrf_token }}塞进请求体(不是 header),字段名严格为csrf_token;用X-CSRF-Token头会直接失败
富文本编辑器提交时容易 403?绕过要精准
像 Quill、TinyMCE 这类前端编辑器常走 JSON 提交,不带 csrf_token 字段,触发默认拦截。不能全局关 CSRF,也不能硬塞 header——revel-csrf 只认 body 字段。
- 推荐方案:在对应 controller 方法上加
revel.InterceptFunc,函数内执行c.Params.Set("csrf.token", "skip"),仅对该 action 放行 - 别用
c.Session.Clear()后就以为 token 失效了——token 绑定的是 session ID,不是用户登录态;登出后 session ID 没变,旧 token 仍有效,可能被重放 - 如果用内存 session(默认),重启服务 token 全丢;生产务必换成 Redis 后端,否则分布式部署下 token 校验必然错配
真正卡住人的从来不是“怎么开”,而是 token 生命周期和 session 存储的一致性——session 用内存,token 却指望跨机器验证;app.secret 每次启动都变;登出不清 session ID。这些点一错,403 就静默发生,日志里还看不出原因。


















