Laravel 8 提交表单报 419 CSRF token 校验失败怎么解决

现象

Laravel 8 项目登录页提交表单,页面直接跳到 419 Page Expired,表单里明明写了 @Csrf。更奇怪的是有人在浏览器里能登录,有人怎么试都不行,清一次 cookie 又恢复正常。

原因

419 表示 CSRF token 校验失败,问题几乎都出在 session 上。storage/framework/sessions 目录权限不对,token 写不进去;SESSION_DRIVER 还是 file,多台后端各自保存导致 token 对不上;APP_URL 与浏览器实际访问的域名不一致,cookie 域不同;执行过 config:cache,缓存里还是旧配置;页面被 CDN 或浏览器缓存,提交的是带旧 token 的 HTML。

解决步骤

第一步,确认 session 驱动和目录权限。看 .env 里的配置,再看 session 目录属主是否与 PHP-FPM 运行用户一致,顺手清掉配置缓存让修改立即生效。

grep -E "SESSION_DRIVER|APP_URL" .env
ls -ld storage/framework/sessions
php artisan config:clear && php artisan cache:clear

第二步,多机部署改成集中存储。把 SESSION_DRIVER 换成 redis,所有节点连同一个实例,并把 APP_URL 统一成 HTTPs 正式域名。

第三步,别让登录页被缓存。在 Nginx 或 CDN 里对登录页与后台加 no-cache,模板里确认 @csrf 在 form 内部;需要豁免的接口只加白名单,不要整站关闭校验。

验证

连续多次提交登录表单都能成功,刷新登录页后再提交也不报 419,多台后端之间切换访问依旧保持登录状态,日志里不再出现 TokenMismatchException。

小结

419 不是表单写错,而是 token 在某个环节丢了。先保证 session 能写、能共享,再统一域名与缓存策略,比在模板里反复加 @csrf 有效得多。

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