Laravel 修改验证异常的响应格式实例代码详解

网络编程 2026/1/19 佚名

3 2 1

Laravel 默认验证不通过后响应格式如下，有时此格式并不满足自己要求，需要修改格式。

// status 422
{
 "message":"The given data was invalid.",
 "errors":{
  "url":[
   "url 无效的格式"
  ]
 }
}

当 Request 验证失败时会抛出 ValidationException异常，最终交由全局异常Handler类处理。Handler继承自Illuminate\Foundation\Exceptions\Handler，框架中的Handler类调用render处理异常并进行响应，针对于ValidationException异常又调用了convertValidationExceptionToResponse方法来处理。代码

protected function convertValidationExceptionToResponse(ValidationException $e, $request)
{
 if ($e->response) {
  return $e->response;
 }

 return $request->expectsJson()
    "htmlcode">

protected function invalidJson($request, ValidationException $exception)
{
 return response()->json([
  'message' => $exception->getMessage(),
  'errors' => $exception->errors(),
 ], $exception->status);
}


追踪到invalidJson()，发现他就是用来处理参数验证异常响应格式的方法。在App\Exceptions\Handler类中，重写invalidJson()方法即可。


protected function invalidJson($request, ValidationException $exception)
{
 return response()->json([
  'code' => 0,
  'data' => $exception->errors(),
 ], $exception->status);
}


最终，验证失败的响应格式如下


// status 422
{
 "code": 0,
 "data":{
  "url":[
   "url 无效的格式"
  ]
 }
}


总结