Laravel如何处理异常和错误？（Handler示例）-Laravel-PHP中文网

Laravel如何处理异常和错误？（Handler示例）

尼克

发布： 2025-12-23 15:10:03

原创

994人浏览过

Laravel异常处理由App\Exceptions\Handler类统一管理，核心是report()方法记录异常、render()方法返回响应；需按请求类型（网页/API）和异常语义定制逻辑，避免生产环境开启调试模式。

laravel如何处理异常和错误？（handler示例）

在 Laravel 中，异常和错误统一由 App\Exceptions\Handler 类处理，它负责记录、渲染和响应各类异常。核心逻辑集中在 render() 和 report() 两个方法上，自定义时无需重写整个流程，只需按需覆盖即可。

report() 方法：记录异常到日志或第三方服务

该方法用于“上报”异常，比如写入日志、发送告警、同步到 Sentry 等。Laravel 默认已调用 Log::error() 记录所有未捕获异常。

常见扩展方式：

对特定业务异常（如 OrderException）额外触发企业微信/钉钉通知
忽略某些预期异常（如 ValidationException），避免刷屏日志
补充上下文信息（用户 ID、请求 URL、IP）便于排查

示例：

自学 PHP、MySQL和Apache

本书将PHP开发与MySQL应用相结合，分别对PHP和MySQL做了深入浅出的分析，不仅介绍PHP和MySQL的一般概念，而且对PHP和MySQL的Web应用做了较全面的阐述，并包括几个经典且实用的例子。本书是第4版，经过了全面的更新、重写和扩展，包括PHP5.3最新改进的特性（例如，更好的错误和异常处理），MySQL的存储过程和存储引擎，Ajax技术与Web2.0以及Web应用需要注意的安全

406

查看详情

public function report(Throwable $throwable): void
{
    if ($throwable instanceof CustomBusinessException) {
        \Log::warning('业务异常', [
            'message' => $throwable->getMessage(),
            'user_id' => auth()->id(),
            'url' => request()->fullUrl(),
        ]);
        // 可选：发通知
        notifyAdmin("⚠️ 业务异常：{$throwable->getMessage()}");
    }

    parent::report($throwable);
}

登录后复制

render() 方法：决定如何向用户返回响应

该方法决定异常“怎么展示”，返回一个 Response 实例。Laravel 默认对 HTTP 异常（如 404、500）返回视图，对 API 请求返回 JSON。

关键点：

通过 $request->expectsJson() 判断是网页还是 API 请求
可针对不同异常类型返回定制化响应（如模型未找到时返回 404 JSON）
不建议在 render 中抛出新异常，否则可能陷入递归

示例：

public function render($request, Throwable $throwable): Response|ResponseFactory
{
    if ($throwable instanceof ModelNotFoundException && $request->expectsJson()) {
        return response()->json([
            'message' => '资源不存在',
            'error' => 'not_found',
        ], 404);
    }

    if ($throwable instanceof ValidationException && $request->expectsJson()) {
        return response()->json([
            'message' => '验证失败',
            'errors' => $throwable->errors(),
        ], 422);
    }

    return parent::render($request, $throwable);
}

登录后复制