PHP中如何简化多种自定义异常捕获并返回对应输出？

一、通过分层异常类简化捕获 #

你提到的ResponseException思路完全可行，这也是最简洁的解决方案之一，具体实现步骤如下：

1. 定义顶层ResponseException，让它继承你的CustomExceptions，内置状态码属性和获取方法：

class ResponseException extends CustomExceptions
{
    protected int $statusCode;

    public function __construct(int $statusCode, string $message = "", Throwable $previous = null)
    {
        parent::__construct($message, 0, $previous);
        $this->statusCode = $statusCode;
    }

    public function getStatusCode(): int
    {
        return $this->statusCode;
    }
}

2. 让所有和HTTP状态相关的异常继承这个ResponseException：

// 404路由不存在异常
class RouteNotFoundException extends ResponseException
{
    public function __construct(string $message = "路由不存在", Throwable $previous = null)
    {
        parent::__construct(404, $message, $previous);
    }
}

// 405请求方法不允许异常
class MethodNotAllowedException extends ResponseException
{
    public function __construct(string $message = "请求方法不允许", Throwable $previous = null)
    {
        parent::__construct(405, $message, $previous);
    }
}

// 500路由内部处理异常
class RoutingException extends ResponseException
{
    public function __construct(string $message = "路由处理异常", Throwable $previous = null)
    {
        parent::__construct(500, $message, $previous);
    }
}

3. 此时在index.php里只需捕获一次ResponseException，就能处理所有HTTP状态相关异常：

try {
    $route->run();
} catch (ResponseException $e) {
    // 顺便设置HTTP响应状态码
    http_response_code($e->getStatusCode());
    view($e->getStatusCode());
} catch (CustomExceptions $e) {
    // 处理其他业务类自定义异常，比如返回统一业务错误视图
    view('custom-error', ['message' => $e->getMessage()]);
} catch (Throwable $e) {
    // 兜底处理所有未捕获的系统异常
    http_response_code(500);
    view(500);
}

二、额外优化：异常-视图映射配置（可选） #

如果不想为每个状态码单独编写异常类，还可以用异常类与视图的映射数组来简化逻辑：

先定义映射关系：

$exceptionViewMap = [
    RouteNotFoundException::class => 404,
    MethodNotAllowedException::class => 405,
    RoutingException::class => 500,
    // 可继续添加其他自定义异常与对应视图的映射
];

然后在catch块中通过类名匹配映射：

try {
    $route->run();
} catch (CustomExceptions $e) {
    $exceptionClass = get_class($e);
    if (isset($exceptionViewMap[$exceptionClass])) {
        $viewName = $exceptionViewMap[$exceptionClass];
        http_response_code(is_numeric($viewName) ? $viewName : 500);
        view($viewName);
    } else {
        // 处理未配置的自定义异常
        view('custom-error', ['message' => $e->getMessage()]);
    }
} catch (Throwable $e) {
    http_response_code(500);
    view(500);
}

这种方式不需要新增ResponseException类，适合异常类型固定、不需要额外状态码逻辑的快速迭代场景。

三、方案总结 #

• 优先推荐分层异常类方案，它更符合面向对象设计，扩展性更强（后续新增异常只需继承ResponseException并指定状态码即可）。
• 异常映射配置适合异常类型不多的场景，代码更简洁直观。

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