Laravel POST 请求出现 Page Expired 常见原因？

一、Laravel POST 请求出现 Page Expired 的常见原因及解决方案

在 Laravel 开发过程中，开发者常常会遇到提交 POST 请求时出现“Page Expired”（页面过期）的错误提示。这种错误不仅影响用户体验，还可能导致业务流程中断。本文将深入分析导致该错误的常见原因，并提供对应的解决方案。

1. CSRF Token 过期或缺失

Laravel 默认启用了 CSRF 保护机制，用于防止跨站请求伪造攻击。当用户访问一个表单页面时，Laravel 会生成一个 CSRF Token，并将其存储在 Session 中。同时，该 Token 也会被嵌入到页面的表单中（通常是一个隐藏字段）。

如果页面停留时间过长，导致 Session 过期或 Token 被清除，再次提交表单时就会出现“Page Expired”错误。

• 常见现象：页面长时间未提交，刷新后再次提交
• 解决方案：
  • 检查 Session 配置，适当延长 Session 生命周期
  • 在表单中手动添加 @csrf 指令
  • 使用 AJAX 提交时，手动在请求头中添加 XSRF-TOKEN

2. 表单提交时未正确携带 Token

在某些情况下，开发者可能手动构建表单或使用 JavaScript 提交请求，而忽略了携带 CSRF Token。

// AJAX 请求中携带 Token 的示例
$.ajax({
    url: '/submit',
    type: 'POST',
    headers: {
        'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
    },
    data: { ... }
});

3. Session 过期或配置异常

Session 是 Laravel 用于存储用户状态的核心机制之一。CSRF Token 依赖于 Session 存储，因此 Session 过期或配置错误会直接导致 Token 丢失。

常见原因包括：

• Session 驱动配置错误（如使用了不稳定的缓存驱动）
• Session 生命周期过短（如默认为 120 分钟）
• 服务器时间与客户端时间不同步

解决方法：

• 检查 config/session.php 中的 lifetime 设置
• 确保 Session 驱动（如 file、redis、database）正常工作
• 同步服务器时间

4. 缓存问题

在某些部署环境中，缓存机制（如浏览器缓存、CDN 缓存、OPcache）可能会导致旧页面被缓存，从而使用了过期的 CSRF Token。

解决方案：

• 禁用浏览器缓存敏感页面（通过设置响应头）
• 在 CDN 中配置缓存排除规则
• 检查 PHP OPcache 是否影响了 Session 的写入