Laravel提交用户ID查询支付记录表单报419 PAGE EXPIRED错误

业务场景 #

实现用户输入本人ID查询对应支付记录的功能，项目中定义Customer、Payment两个模型，二者为一对多关联关系，原有实现代码如下。

原有实现代码 #

前端表单代码 #

<form action= "{{url('/Check')}}" method="POST" enctype="multipart/from-data">
    @csrf    
    <div class="row gtr-uniform">
            <h3>Please Enter your National ID</h3>
            <div class="col-6 col-12-xsmall">
                <input type="text" name="cust_id" id="cust_id" value="" placeholder="ID" required/>
            </div>
            
            <!-- Break -->
            <div class="col-6 col-12-xsmall">
                <ul class="actions">
                    <li><input type="submit" id="btnclaim" value="Search" class="primary" /></li>
                    <li><input type="reset" value="Reset" /></li>
                </ul>
            </div>
        </div>
    </form>

路由定义代码 #

Route::post('/Check',[paymetController::class,'Check']);

控制器方法代码 #

public function Check(Request $request){
    $cust_id=$request->CustomerID;
    $pay=Customer::with('payment')->find($cust_id);
    return view('DisplayPay',compact('pay'));
}

419错误直接原因 #

Laravel的419错误统一由CSRF令牌校验失败触发，当前代码里直接导致校验失败的原因是表单enctype属性拼写错误：

• 代码中写的是multipart/from-data，正确的MIME类型值应为multipart/form-data，拼写错误会导致浏览器提交请求时无法正确解析表单数据，后端拿不到@csrf指令生成的_token隐藏字段值，直接判定CSRF校验不通过返回419。

完整修复方案 #

• 修正表单enctype属性：若当前表单不需要上传文件，可直接删除enctype属性，使用默认的application/x-www-form-urlencoded编码即可满足普通文本提交需求；如果需要保留文件上传能力，将属性值改为正确的multipart/form-data。
• 若修正enctype后仍报419，按以下顺序排查：
  1. 确认Linux环境下项目storage目录具备可写权限，执行chmod -R 755 storage命令修正权限，权限不足会导致会话无法存储、CSRF令牌无法正常校验。
  2. 浏览器右键查看页面源代码，确认表单内正常渲染出<input type="hidden" name="_token" value="随机字符串">的隐藏字段，若没有该字段说明Blade模板的@csrf指令未被正确解析。
  3. 确认app/Http/Middleware/VerifyCsrfToken.php中间件中，没有将/Check路由错误加入CSRF白名单之外的异常配置。
• 修复其余影响功能正常运行的代码问题（即使解决419也会触发报错）：
  1. 修正控制器取参逻辑：前端输入框的name属性为cust_id，原有代码取$request->CustomerID无法拿到提交的用户ID，需改为$cust_id = $request->input('cust_id');
  2. 修正路由中控制器类名拼写错误：paymetController存在拼写遗漏，需和实际控制器类名完全一致（通常为PaymentController），注意类名大小写匹配。
  3. 补充空数据判断：当用户输入的ID不存在时$pay会返回null，直接传给前端渲染会报空对象错误，可在查询后加判断，不存在时返回错误提示。

内容的提问来源于stack exchange，提问作者fyafee