如何在Laravel应用的控制器外或任意位置抛出JSON响应格式异常

自定义异常类 #

Laravel自带的异常处理体系支持全局捕获所有抛出的异常，你只需要创建继承自HTTP基础异常的自定义类，就可以在任意位置调用抛出，自动返回JSON响应。
在app/Exceptions目录下新建ConflictException.php文件，写入以下代码：

<?php

namespace App\Exceptions;

use Symfony\Component\HttpKernel\Exception\HttpException;

class ConflictException extends HttpException
{
    public function __construct(string $message = '', \Throwable $previous = null, array $headers = [], int $code = 0)
    {
        // 409是Conflict对应的HTTP状态码，可根据需求修改
        parent::__construct(409, $message, $previous, $headers, $code);
    }

    // 强制所有场景下返回JSON，不需要的话可以删除这个方法，Laravel会自动根据请求头返回对应格式
    public function render($request)
    {
        return response()->json([
            'code' => $this->getStatusCode(),
            'message' => $this->getMessage()
        ], $this->getStatusCode(), $this->getHeaders());
    }
}

调用方式 #

直接调用 #

在项目任意位置（中间件、服务类、模型、工具函数等）都可以直接抛出：

throw new \App\Exceptions\ConflictException('any');

简化调用 #

如果不想每次写完整命名空间，可以在config/app.php的aliases数组中添加别名：

'aliases' => [
    // 原有其他别名保持不变
    'ConflictException' => App\Exceptions\ConflictException::class,
],

配置后就可以用你期望的写法直接调用：

throw new ConflictException('any');

扩展其他异常 #

如果需要其他状态码的异常（比如400参数错误、401未授权、403无权限、404不存在），只需要按照上面的模板新建对应异常类，修改构造方法里的HTTP状态码即可，使用逻辑完全一致。

注意事项 #

• 命令行场景下抛出异常默认返回文本格式错误，符合命令行使用习惯，不会影响web场景的JSON返回
• 如果你手动修改过app/Exceptions/Handler.php的默认逻辑，确保保留了HTTP异常的渲染逻辑，否则自定义异常的响应会失效

内容的提问来源于stack exchange，提问作者Bruno Leandro de Sousa Vieira