当前位置：首页 > 文章列表 > 文章 > php教程 > Laravel自定义异常怎么写｜异常类创建教程

Laravel自定义异常怎么写｜异常类创建教程

2026-05-26 19:30:34 0浏览收藏

在 Laravel 中，直接使用 `throw new Exception()` 会导致业务异常被统一降级为 500 错误，使前端无法获取精准的业务码、HTTP 状态码和可读错误信息，日志也难以分类追踪；真正可靠的解法是创建以 `Exception` 结尾、实现 `Responsable` 接口的自定义异常类（如 `InsufficientBalanceException`），并在 `Handler::render()` 中为其定制 JSON 响应、在 `Handler::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);
    }
}