Laravel 10.x中如何正确设置默认异常渲染方法？

在Laravel中，重写App\Exceptions\Handler的render方法会直接覆盖register里通过renderable注册的特定异常处理逻辑，两者互斥。要优雅解决默认异常渲染的问题，最佳方案是完全基于register方法中的renderable链来构建异常处理逻辑，具体步骤如下：

1. 注册特定异常的自定义渲染 #

先针对需要特殊处理的异常，逐个注册renderable闭包，逻辑独立清晰：

public function register(): void
{
    // 处理CustomExceptionA异常
    $this->renderable(function (CustomExceptionA $e) {
        return response()->json([
            'error' => $e->getMessage(),
            'details' => 'some custom stuff'
        ], 400);
    });

    // 处理CustomExceptionB异常
    $this->renderable(function (CustomExceptionB $e) {
        return response()->json([
            'error' => $e->getMessage(),
            'details' => 'some other custom stuff'
        ], 404);
    });

    // 下面添加全局默认处理
}

2. 添加全局默认异常兜底处理 #

在register方法的末尾，注册一个针对Throwable类型的renderable闭包，作为所有未匹配到特定处理的异常的默认逻辑：

$this->renderable(function (Throwable $e) {
    // 统一返回JSON格式的错误响应
    $statusCode = $e->getCode() >= 400 && $e->getCode() < 600 ? $e->getCode() : 500;
    return response()->json([
        'error' => $e->getMessage(),
        'code' => $e->getCode() ?: 500
    ], $statusCode);
});

Laravel的renderable机制会按注册顺序匹配异常类型，优先匹配更具体的异常类（比如CustomExceptionA），最后才会匹配最宽泛的Throwable，完美实现"特定异常优先，默认兜底"的逻辑。

3. 可选：区分API与Web请求 #

如果需要同时支持API（JSON响应）和Web页面（HTML响应），可以在兜底逻辑中加入请求判断：

$this->renderable(function (Throwable $e, $request) {
    if ($request->expectsJson()) {
        $statusCode = $e->getCode() >= 400 && $e->getCode() < 600 ? $e->getCode() : 500;
        return response()->json([
            'error' => $e->getMessage(),
            'code' => $e->getCode() ?: 500
        ], $statusCode);
    }

    // 非API请求沿用Laravel默认的HTML异常页面渲染
    return parent::render($request, $e);
});

为什么这是最佳实践？ #

• 相比传统的instanceof堆叠判断，这种方式每个异常的处理逻辑独立拆分，代码更易维护和扩展
• 完全遵循Laravel的设计意图，官方文档更推荐使用renderable来注册异常处理逻辑
• 彻底避免了render方法与renderable逻辑的冲突问题

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