Laravel验证失败返回302状态码的原因及自定义响应方案

为什么返回302（HTTP_FOUND）？ #

Laravel的request->validate()方法有默认的验证失败处理逻辑：

• 当请求未指定Accept: application/json头时，Laravel会将其识别为Web请求，验证失败后自动触发重定向（状态码302），跳回上一页。
• 你的路由定义在api.php中，但测试代码未设置Accept头，导致框架按Web请求处理，触发了默认重定向行为。
• 另外，你用try-catch(Exception $e)包裹的验证逻辑并未生效：request->validate()抛出的是ValidationException，Laravel框架会优先拦截该异常并执行重定向，你的catch块根本不会被触发。

如何返回合理的HTTP状态码？ #

API场景下，验证失败的标准状态码是422 Unprocessable Entity，可以通过以下方式实现：

方法1：在测试中添加JSON请求头 #

修改测试代码，明确告知Laravel这是JSON请求：

public function testValidationFailure(){
    $new_item_data = ['bad_param' => 'fancy_name'];
    $response = 
    $this->withHeaders([
        'identifier' => "identifier",
        'Accept' => 'application/json' // 新增该请求头
    ])
    ->post("localhost/item", $new_item_data);
    $response->assertStatus(Response::HTTP_UNPROCESSABLE_ENTITY); // 断言422状态码
    echo "status:" . $response->status();
}

此时request->validate()会自动返回422状态码的JSON响应，包含验证错误信息，无需额外的catch块。

方法2：手动创建验证器，自定义响应 #

如果需要完全自定义验证失败的响应内容和状态码，可改用Validator类手动验证：

use Illuminate\Support\Facades\Validator;
use Illuminate\Http\Response;

class ItemController extends Controller{
    public function store(Request $request): JsonResponse{
        $validator = Validator::make($request->all(), [
            'name' => 'required'
        ]);

        if ($validator->fails()) {
            return response()->json([
                'error' => 'validation_failed',
                'messages' => $validator->errors()
            ], Response::HTTP_UNPROCESSABLE_ENTITY);
        }

        // 插入新数据到表中的代码
    }
}

这种方式完全摆脱Laravel默认处理逻辑，可自由控制返回内容。

方法3：全局修改验证异常处理 #

如果希望所有API请求的验证失败都返回统一格式的JSON响应，可修改异常处理器（app/Exceptions/Handler.php）：

use Illuminate\Validation\ValidationException;

public function render($request, Throwable $exception)
{
    if ($exception instanceof ValidationException && $request->expectsJson()) {
        return response()->json([
            'error' => 'validation_failed',
            'messages' => $exception->errors()
        ], 422);
    }

    return parent::render($request, $exception);
}

$request->expectsJson()会自动识别是否为JSON请求（如带Accept: application/json头或AJAX请求），确保所有API场景下验证失败都返回422状态码的JSON响应。

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