Laravel 9中AJAX验证失败返回302而非JSON错误的解决方法

先修正最明显的错误：字段名不匹配 #

你前端Filepond的name属性是images，但后端验证规则里写的是image，这会直接导致「字段必填」的验证失败，先把规则里的字段名改成images保持一致。

核心解决方案：让Laravel返回JSON错误而非重定向 #

Laravel默认对Web请求验证失败会返回302重定向，对API请求才会返回JSON格式错误。你可以通过以下几种方式实现需求：

方式1：让前端请求带上JSON标识头

给Filepond的请求添加Accept: application/json头，告诉Laravel这是一个API请求：

<template>
    <file-pond
        max-files="1"
        name="images"
        :server="{
            url: '/api/images',
            headers: {
                'Accept': 'application/json',
                'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content
            }
        }"
        accepted-file-types="image/jpeg, image/png, image/gif, image/webp"
        :files="file"
    />
</template>

<script setup>
import vueFilePond from 'vue-filepond'
import 'filepond/dist/filepond.min.css'

const file = ''
</script>

方式2：自定义Form Request并强制返回JSON

创建一个专用的表单请求类，重写验证失败的响应逻辑：

1. 生成Form Request文件

php artisan make:request ImageUploadRequest

2. 编辑app/Http/Requests/ImageUploadRequest.php：

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Contracts\Validation\Validator;
use Illuminate\Http\Exceptions\HttpResponseException;

class ImageUploadRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true; // 根据你的权限需求调整，比如判断用户是否登录
    }

    public function rules(): array
    {
        return [
            'images' => 'required|image|dimensions:min_width=1,max_height=1|max:4000',
        ];
    }

    // 重写验证失败逻辑，强制返回JSON
    protected function failedValidation(Validator $validator)
    {
        throw new HttpResponseException(response()->json([
            'errors' => $validator->errors(),
        ], 422));
    }
}

3. 在控制器中使用这个请求类：

use App\Http\Requests\ImageUploadRequest;

public function upload(ImageUploadRequest $request)
{
    // 验证通过后直接执行上传逻辑即可，验证失败会自动返回JSON错误
    // 你的上传代码...
}

方式3：确保路由在api.php中

Laravel的routes/api.php路由默认使用api中间件组，会自动识别API请求并返回JSON错误，把你的上传路由移到这里：

// routes/api.php
use App\Http\Controllers\ImageController;

Route::post('/images', [ImageController::class, 'upload']);

额外提醒 #

你原来控制器里的if ($request->fails())代码永远不会执行，因为$request->validate()验证失败时会直接抛出异常中断请求，不需要手动判断。

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