Laravel 10自定义DatabaseException不生效，如何统一处理数据库错误？

问题根源 #

你犯了两个关键错误：

1. 错误使用$dontReport数组：这个数组的作用是指定哪些异常不需要写入日志，并非用来注册自定义异常处理器，把DatabaseException加在这里完全不会触发你的自定义逻辑。
2. 自定义异常处理器未注册：你创建的DatabaseException继承了ExceptionHandler，但Laravel默认不会自动识别并使用它，必须手动注册才能生效。

解决方法（推荐直接修改默认Handler） #

不需要单独创建DatabaseException.php，直接在默认的app/Exceptions/Handler.php中添加处理逻辑即可：

1. 打开Handler.php，找到register方法
2. 添加renderable回调来处理数据库异常：

public function register()
{
    $this->reportable(function (Throwable $e) {
        // 保留原有代码
    });

    // 处理所有数据库QueryException
    $this->renderable(function (\Illuminate\Database\QueryException $e, $request) {
        // 可选：仅在生产环境生效（APP_DEBUG=false）
        if (!config('app.debug')) {
            return response()->view('pages.servicenotavailable');
        }
        // 调试模式下返回默认错误页面
        return null;
    });
}

备选方案：使用自定义异常处理器 #

如果你坚持用单独的异常处理类，按以下步骤操作：

1. 完善DatabaseException.php的代码，确保实现register方法：

namespace App\Exceptions;

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Throwable;

class DatabaseException extends ExceptionHandler
{
    public function register(): void
    {
        $this->renderable(function (\Illuminate\Database\QueryException $e, $request) {
            return response()->view('pages.servicenotavailable');
        });

        // 继承父类的其他异常处理逻辑
        parent::register();
    }
}

2. 在bootstrap/app.php中替换默认的异常处理器：

$app->singleton(
    Illuminate\Contracts\Debug\ExceptionHandler::class,
    App\Exceptions\DatabaseException::class
);

额外注意事项 #

• 确保resources/views/pages/servicenotavailable.blade.php视图文件存在且内容正确
• 若想在调试模式（APP_DEBUG=true）下也显示自定义视图，移除代码中的环境判断即可

内容的提问来源于stack exchange，提问作者tolga