laravel 接口异常错误返回json数据

最新推荐文章于 2025-06-11 10:24:43 发布

渡目成书

最新推荐文章于 2025-06-11 10:24:43 发布

阅读量900

点赞数

CC 4.0 BY-SA版权

分类专栏： laravel 文章标签： laravel接口

本文链接：https://blog.csdn.net/weixin_43674113/article/details/119382458

laravel 专栏收录该内容

101 篇文章

订阅专栏

本文介绍如何在Laravel中自定义API异常处理流程，通过修改Handler.php中的render方法实现异常以JSON格式返回，并提供了一个扩展的APIResponse类来增强默认响应。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在laravel中默认返回的异常是html的形式展现在页面上面，当我们写接口的时候我们希望错误是一定的json进行展示我们就需要对异常类进行处理改造

找到文件Exceptions\Handler.php的render方法尽心重写

public function render($request, Exception $exception)
    {

        if ($request->is('api/*')) {
            $response = [];
            $error = $this->convertExceptionToResponse($exception);
            $e = FlattenException::create($exception);
            $response['status_code'] = $error->getStatusCode();
            $response['message'] = $error->getStatusText();
            $response['debug']['line'] = $e->getLine();
            $response['debug']['file'] = $e->getFile();
            $response['debug']['class'] = $e->getClass();
            $response['debug']['trace'] = $e->getTrace();
            return response()->json($response, $error->getStatusCode());
        } else {
            return parent::render($request, $exception);
        }

    }

这里我们接口的访问url为api开头，我们对接口进行过滤，web访问还是使用原来的默认方式

$error = $t h i s - > c o n v e r t E x c e p t i o n T o R e s p o n s e ($ exception);

这里能获取到状态码和状态简易信息。注意是convertExceptionToResponse返回的是response类，但是response类里面并没有getStatusText()方法，但是这个类里面有这个成员变量，这个时候我们需要重写这个类。

新建APIResponse类来集成response类，新增 getStatusText() 方法

<?php
namespace App\Exceptions;
use Symfony\Component\HttpFoundation\Response;

class ApiResponse extends Response
{
    /**
     *获取statusText
     */

    public function getStatusText()
    {
        return $this->statusText;
    }

}

在render 方法中重写convertExceptionToResponse 换成ApiResponse 类

 protected function convertExceptionToResponse(Exception $e)
    {

        $e = FlattenException::create($e);

        $handler = new SymfonyExceptionHandler(config('app.debug', false));

        return ApiResponse::create($handler->getHtml($e), $e->getStatusCode(), $e->getHeaders());
    }