Laravel 419 页面已过期 CSRF token 校验失败怎么修

现象

Laravel 10 后台表单提交偶尔返回 419 Page Expired,刷新后重提有时成功,过一段时间又失败。GET 页面正常,日志里没有异常堆栈,只有 VerifyCsrfToken 的拒绝记录。同一套代码在测试环境完全正常。

原因

419 表示请求里的 token 和 session 里的 token 对不上。常见是 session 没保存住:SESSION_DOMAIN 和实际访问域名不一致,带 www 和不带 www 混用;开了 SESSION_SECURE_COOKIE 却用 http 访问;多台机器负载均衡但 session 落在本地文件。也可能是表单漏了 @csrf,AJAX 没带 X-CSRF-TOKEN。

解决步骤

第一步,确认 session 配置。查看 config/session.php 的 driver、domain、secure 三项,和浏览器地址栏的协议、域名逐项对照,先把不一致的改掉。

grep -E "driver|domain|secure" config/session.php
SESSION_DRIVER=redis
SESSION_DOMAIN=.example.com
SESSION_SECURE_COOKIE=false

第二步,让多机共享 session。把驱动改成 redis 或 database,配置统一的连接,确保所有节点读写同一份数据。改完执行 config:clear,避免旧配置被缓存。

php artisan config:clear
php artisan cache:clear
php artisan route:clear

第三步,检查请求是否带 token。表单确认有 @csrf,AJAX 从 meta 标签取 token 放进 X-CSRF-TOKEN 请求头。只有纯 API 场景才考虑把路由加入 except,不要为了省事整组关闭校验。

验证

连续提交十次表单都返回 200 或 302,不再出现 419;浏览器里 session cookie 的 domain 与访问域名一致,多台后端切换后登录状态保持。

小结

419 多数是 session 丢失,不是 token 生成错误。先对齐域名和协议,再让多机共享 session,最后检查请求头。

您可以还会对下面的文章感兴趣: