csrf防护需服务端动态生成、安全传输并严格校验;token须绑定session、禁复用、禁硬编码,前端须从dom安全提取并手动携带至ajax请求头或表单字段。

CSRF防护不是加个隐藏字段就完事了,关键在于服务端生成逻辑、传输路径和校验时机三者必须严丝合缝;否则 403 Forbidden 或 Invalid CSRF token 会频繁出现,尤其在多标签页、页面刷新或 AJAX 提交时。
服务端必须动态生成并绑定 session
Token 值不能硬编码、不能复用、不能从 URL 或 localStorage 读取——浏览器里看到的 csrf_token 值,必须由服务端在渲染 HTML 前实时生成,并写入当前用户 session(或加密后存入 Cookie,但需设 SameSite=Lax)。
- Django 默认将 Token 存 session,若改用
CSRF_USE_SESSIONS = False,则 Token 存 Cookie,此时必须确保响应头含Set-Cookie: csrftoken=...; SameSite=Lax - Flask +
flask-wtf中,{{ form.hidden_tag() }}自动注入 Token,但前提是请求已触发session初始化(比如用户已登录或访问过带 session 的路由) - Express 使用
csurf(已废弃)或csrf-protection时,中间件必须挂载在body-parser之后、路由之前,否则req.body为空导致校验失败
前端必须从 DOM 读取,不能硬编码或跨域传
Token 不会自动进 AJAX 请求体或 header,前端必须手动提取并携带;且不能把值写死在 JS 里,也不能从第三方来源(如 URL 参数、localStorage)获取——XSS 漏洞下这些地方极易被读取。
- 推荐方式:在 HTML 中用
<meta name="csrf-token" content="{{ csrf_token }}">,JS 里用document.querySelector('meta[name="csrf-token"]')?.getAttribute('content')获取 - 表单提交可直接用 hidden 字段:
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">,但仅适用于传统 form submit - fetch 发送 POST/PUT/DELETE 时,必须显式设置 header:
headers: { 'X-CSRF-Token': token };若服务端没配置从 header 读取(如 Django 需设CSRF_HEADER_NAME = 'HTTP_X_CSRF_TOKEN'),请求照样 403
校验失败常见原因与排查点
Invalid CSRF token 看似是前端漏传,实际八成是服务端配置或生命周期处理出错。
- 多标签页同时打开同一页面 → 若服务端启用“一次性 Token”(如某些 PHP 实现),第二个标签提交时 Token 已被消耗,直接报错;应改用“每会话单 Token”模式
- 页面后退再提交 → 浏览器可能缓存旧 HTML(含过期 Token),需在服务端响应加
Cache-Control: no-store, no-cache - AJAX 请求返回 403 但表单提交正常 → 说明服务端只校验
req.body.csrf_token,没检查req.headers['x-csrf-token'],需补全 header 读取逻辑 - Token 值长度异常短(如只有 8 位)→ 可能用了弱随机源(如
Math.random()),应改用crypto.randomUUID()(前端临时生成仅作参考)或服务端secrets.token_urlsafe(32)类安全函数
最易被忽略的是 Token 生命周期与会话一致性的耦合:Token 失效不该只靠时间,而应和服务端 session 销毁同步;一旦用户登出或 session 过期,对应 Token 必须立即失效,否则攻击者仍可能重放旧请求。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











