Laravel多表单提交419错误解决方法

本文针对Laravel应用中多表单提交时，首个表单成功而后续表单出现419 | PAGE EXPIRED错误的问题，进行了深入分析并提供了详细的解决方案。该错误通常源于CSRF令牌验证失败，Laravel通过CSRF保护机制防止跨站请求伪造。文章首先解释了Laravel的CSRF保护机制，以及419错误的常见原因，包括CSRF令牌缺失或会话过期。然后，通过分析问题场景，指出错误可能出现在视图层，即第二个表单缺少CSRF令牌。针对此问题，本文提供了在Blade模板中使用`@csrf`指令添加CSRF令牌的简易方法，并给出了包含`@csrf`指令的完整表单示例。此外，还涵盖了AJAX请求中CSRF令牌的处理、会话过期问题的应对以及CSRF排除的注意事项，旨在帮助开发者全面理解和解决Laravel中的419错误，确保应用安全稳定运行。

理解Laravel中的419错误

在Laravel框架中，419 | PAGE EXPIRED错误通常表示CSRF（跨站请求伪造）令牌验证失败。Laravel默认开启了CSRF保护，以防止恶意攻击者冒充合法用户提交请求。当一个POST、PUT、PATCH或DELETE请求发送到服务器时，Laravel会检查请求中是否包含一个有效的CSRF令牌。如果令牌缺失、无效或与会话中的令牌不匹配，框架就会抛出419错误。

此外，会话过期也可能导致419错误，因为CSRF令牌是与用户会话绑定的。如果用户长时间不活动导致会话过期，即使表单中包含令牌，该令牌也可能不再有效。

Laravel的CSRF保护机制

Laravel通过在每个用户会话中生成一个唯一的CSRF“令牌”来保护应用程序免受跨站请求伪造。这个令牌被存储在用户的会话中，并且在每次渲染表单时，都会将其嵌入到一个隐藏的表单字段中。当表单被提交时，Laravel的VerifyCsrfToken中间件会比较请求中提供的令牌与会话中存储的令牌。如果它们不匹配，请求将被拒绝。

问题场景分析

根据描述，用户在一个页面上使用了两个不同的视图文件来承载两个独立的表单。第一个表单能够成功提交数据并读取，而第二个表单提交时却遇到了419 | PAGE EXPIRED错误。这强烈暗示问题出在第二个表单的CSRF令牌上。

我们来回顾一下用户提供的代码片段：

路由定义 (routes/web.php)：

Route::group([
    'prefix' => 'atribut',
    'as' => 'atribut.'
], function () {
    Route::group(['prefix' => 'tabHome', 'as' => 'tabHome.'], function () {
        Route::get('', [AtributDashboardController::class, 'showTab'])->name('showTab');

        Route::post('addDataFirst', [AtributDashboardController::class, 'addDataFirst'])->name('addDataFirst');
        Route::get('deleteDataFirst/{id}', [AtributDashboardController::class, 'deleteDataFirst'])->name('deleteDataFirst');

        Route::post('addDataSecond', [AtributDashboardController::class, 'addDataSecond'])->name('addDataSecond');
        Route::get('deleteDataSecond/{id}', [AtributDashboardController::class, 'deleteDataSecond'])->name('deleteDataSecond');
    });
});

控制器方法 (AtributDashboardController.php)：

public function __construct()
{
    $this->inpDataFirst = new inpDataFirst ();
    $this->inpDataSecond = new inpDataSecond ();
}

public function addDataFirst()
{
    $data = [
        'name' => Request()->nameForm,
        'address' => Request()->addressForm,
    ];
    $this->inpDataFirst->addData($data);
    return redirect('atribut/tabHome');
}

public function addDataSecond()
{
    $data = [
        'name' => Request()->nameForm,
        'address' => Request()->addressForm,
    ];
    $this->inpDataSecond->addData($data);
    return redirect('atribut/tabHome');
}

表单动作（在Blade视图中）：

第一个表单：

<form action="{{route('frontend.atribut.tabHome.addDataFirst')}}" method="POST">
    <!-- ... 表单字段 ... -->
</form>

第二个表单：

<form action="{{route('frontend.atribut.tabHome.addDataSecond')}}" method="POST">
    <!-- ... 表单字段 ... -->
</form>

从上述代码中可以看出，路由和控制器方法都定义得非常标准，没有明显错误。问题最可能出在视图层，即表单中缺少了CSRF令牌。由于第一个表单能够成功提交，我们推断它可能已经包含了CSRF令牌（即使在问题描述中没有直接显示）。而第二个表单则很可能遗漏了这一关键部分。

解决方案：添加CSRF令牌

解决419 | PAGE EXPIRED错误的最直接方法是确保所有POST、PUT、PATCH或DELETE类型的表单都包含CSRF令牌。在Laravel的Blade模板中，这可以通过使用@csrf指令轻松实现。

@csrf指令会渲染一个隐藏的HTML输入字段，其中包含了当前会话的CSRF令牌。例如：

<input type="hidden" name="_token" value="你的CSRF令牌值">

要修复第二个表单，只需在

<!-- views/your_first_view.blade.php -->
<form method="POST" action="{{ route('frontend.atribut.tabHome.addDataFirst') }}">
    @csrf
    <label for="name1">姓名:</label>
    &lt;input type=&quot;text&quot; id=&quot;name1&quot; name=&quot;nameForm&quot; placeholder=&quot;请输入姓名&quot;&gt;
    <br>
    <label for="address1">地址:</label>
    &lt;input type=&quot;text&quot; id=&quot;address1&quot; name=&quot;addressForm&quot; placeholder=&quot;请输入地址&quot;&gt;
    <br>
    <button type="submit">提交第一个表单</button>
</form>

<!-- views/your_second_view.blade.php -->
<form method="POST" action="{{ route('frontend.atribut.tabHome.addDataSecond') }}">
    @csrf
    <label for="name2">姓名:</label>
    &lt;input type=&quot;text&quot; id=&quot;name2&quot; name=&quot;nameForm&quot; placeholder=&quot;请输入姓名&quot;&gt;
    <br>
    <label for="address2">地址:</label>
    &lt;input type=&quot;text&quot; id=&quot;address2&quot; name=&quot;addressForm&quot; placeholder=&quot;请输入地址&quot;&gt;
    <br>
    <button type="submit">提交第二个表单</button>
</form>