Laravel自定义异常怎么写_Laravel异常类创建【详解】-php教程-PHP中文网

直接 throw new Exception() 不行，因 Laravel 默认将其视为 500 错误，导致前端收不到业务码、HTTP 状态码错误、日志混杂；须自定义实现 Responsable 接口的异常类（如 InsufficientBalanceException），并在 Handler::render() 和 report() 中分别处理响应与日志。

laravel自定义异常怎么写_laravel异常类创建【详解】

直接 throw new Exception() 为什么不行

因为 Laravel 的异常处理器默认把所有 Exception 当作 500 错误，前端收不到业务码、HTTP 状态码也不对，日志里还混着一堆无法分类的堆栈。比如 throw new Exception('库存不足')，你没法让 API 返回 409，也没法让前端根据 code: 'stock_shortage' 做重试逻辑。

自定义异常类必须实现 Responsable 接口

只有实现 Illuminate\Contracts\Support\Responsable，Laravel 才能在 render() 阶段自动调用它的 toResponse() 方法，生成标准 JSON 响应。继承 Exception 或 RuntimeException 只是语义正确，但不解决响应问题。

类名必须以 Exception 结尾（如 InsufficientBalanceException），否则 IDE 和静态分析工具会忽略其异常语义
构造函数里可以预设 $message 和 $code，但状态码不能硬编码在类里——得由 toResponse() 动态决定
toResponse() 必须返回 Illuminate\Http\Response 实例，不能只 return array

class InsufficientBalanceException extends RuntimeException implements Responsable
{
    public function toResponse($request)
    {
        return response()->json([
            'code' => 'balance_insufficient',
            'message' => $this->getMessage(),
        ], 402);
    }
}