Lumen 5.7自定义Reportable&Renderable Exception失效问题咨询

我之前在Lumen 5.7里也碰到过一模一样的情况，其实核心问题大多出在异常处理器的逻辑或者自定义异常的写法上，不需要额外注册异常类，下面给你梳理几个关键检查点：

1. 先确认自定义异常类的写法是否正确 #

你的自定义异常类需要直接继承Exception，并且正确定义report()和render($request)方法，参数和返回值要符合要求：

namespace App\Exceptions;

use Exception;

class CustomRenderableException extends Exception
{
    // 自定义报告逻辑（比如记录日志、发送告警）
    public function report()
    {
        \Log::error('自定义异常触发：'.$this->getMessage());
    }

    // 自定义响应逻辑，必须接收$request参数
    public function render($request)
    {
        return response()->json([
            'code' => $this->getCode() ?: 400,
            'message' => $this->getMessage()
        ], $this->getCode() ?: 400);
    }
}

2. 检查异常处理器的report和render方法 #

Lumen默认的App\Exceptions\Handler会自动检查异常类是否有report或render方法，如果有就优先调用。但如果你重写了这两个方法，一定要保留这个检查逻辑，否则会直接跳过自定义异常的方法：

正确的report方法示例： #

public function report(Exception $e)
{
    // 优先调用异常自身的report方法
    if (method_exists($e, 'report')) {
        return $e->report();
    }

    // 后续是你的自定义报告逻辑或父类默认逻辑
    parent::report($e);
}

正确的render方法示例： #

public function render($request, Exception $e)
{
    // 优先调用异常自身的render方法
    if (method_exists($e, 'render')) {
        return $e->render($request);
    }

    // 后续是你的自定义响应逻辑或父类默认逻辑
    return parent::render($request, $e);
}

如果你的Handler里删掉了这段检查代码，自定义异常的方法肯定不会被执行。

3. 确认异常被正确抛出 #

检查抛出异常的代码，确保你抛出的是自己定义的那个异常类，别写错命名空间：

// 注意命名空间要和自定义异常类一致
throw new \App\Exceptions\CustomRenderableException('测试自定义异常', 403);

要是不小心抛出了原生Exception或者其他异常类，自然不会触发你的自定义方法。

4. 排查是否有提前捕获异常的逻辑 #

如果你的代码里用try-catch捕获了这个异常，但没有重新抛出，而是直接处理了，那异常就不会走到全局异常处理器，也就不会触发render和report方法。比如这种情况要调整：

try {
    // 触发异常的代码
} catch (CustomRenderableException $e) {
    // 做局部处理后记得重新抛出，让全局处理器接手
    \Log::info('局部记录异常：'.$e->getMessage());
    throw $e;
}

按照上面这几个步骤排查，基本上就能解决问题了，Lumen会自动识别并调用异常自身的方法，不需要额外的注册配置。

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