Laravel怎么自定义错误页面和异常处理

答案是通过修改Handler.php中的render方法可自定义异常响应，如ModelNotFoundException返回404视图；在resources/views/errors/下创建对应状态码的Blade文件即可实现错误页面定制；需将APP_ENV设为production并关闭DEBUG才能预览页面；同时可在report方法中记录异常日志。

在 Laravel 中自定义错误页面和异常处理非常灵活，你可以通过修改异常处理器和添加视图文件来实现。以下是具体操作步骤。

1. 自定义异常处理

Laravel 的异常处理主要由 App/Exceptions/Handler.php 文件控制。这个类中的 render() 方法负责将异常转换为 HTTP 响应。

你可以在这里拦截特定异常并返回自定义响应。例如：

public function render($request, Exception $exception)
{
    if ($exception instanceof ModelNotFoundException) {
        return response()->view('errors.model-not-found', [], 404);
    }

    if ($exception instanceof AuthorizationException) {
        return response()->view('errors.unauthorized', [], 403);
    }

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

这样当出现模型未找到或权限不足时，就会跳转到你指定的视图页面。

2. 创建自定义错误页面视图

Laravel 默认会在 resources/views/errors/ 目录下查找对应状态码的视图文件。

你只需创建对应 HTTP 状态码的 Blade 模板即可。例如：

• resources/views/errors/404.blade.php — 页面不存在
• resources/views/errors/500.blade.php — 服务器内部错误
• resources/views/errors/403.blade.php — 禁止访问
• resources/views/errors/419.blade.php — 表单过期

只要这些文件存在，Laravel 就会自动使用它们渲染错误页面。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

3. 测试自定义错误页面

开发环境下，Laravel 会显示详细的调试页面。要查看你的自定义错误页，需切换到生产环境。

可以临时修改 .env 文件：

APP_ENV=production
APP_DEBUG=false

然后手动触发一个 404 错误（如访问不存在的路由），就能看到你定义的 404 页面了。

4. 全局异常记录与通知

在 Handler.php 的 report() 方法中，你可以记录特定异常或发送通知。

public function report(Exception $exception)
{
    if ($exception instanceof CustomBusinessException) {
        \Log::warning('业务异常：' . $exception->getMessage());
    }

    parent::report($exception);
}

这样可以在不影响用户的情况下，将关键异常记录下来。

基本上就这些。通过结合异常处理逻辑和视图模板，你可以完全掌控 Laravel 应用的错误展示方式，提升用户体验。

以上就是Laravel怎么自定义错误页面和异常处理的详细内容，更多请关注php中文网其它相关文章！