PHP项目错误与Throwable

本文目录导读：

1. Throwable 接口族谱
2. 为什么要区分 Exception 和 Error？
3. 在项目中的正确实践
4. 实战建议汇总
5. PHP 8 的进步与注意点

在PHP项目中，Throwable 是一个核心接口，它定义了所有可抛出的错误和异常的基础行为，理解它的层级和用途,对于编写健壮的错误处理代码至关重要。

Throwable 接口族谱

这是PHP 7+ 引入的关键变化，统一了错误（Error）和异常（Exception）的处理路径。

Throwable (Interface)
│
├── Exception (Class, implements Throwable)
│   ├── LogicException
│   │   ├── InvalidArgumentException
│   │   ├── LengthException
│   │   └── BadFunctionCallException (含 BadMethodCallException)
│   ├── RuntimeException
│   │   ├── OutOfBoundsException
│   │   ├── OverflowException
│   │   ├── UnderflowException
│   │   ├── RangeException
│   │   ├── UnexpectedValueException
│   │   └── PDOException (扩展了 RuntimeException)
│   └── ... (其他用户自定义或库扩展)
│
└── Error (Class, implements Throwable)
    ├── TypeError
    ├── ArgumentCountError
    ├── ArithmeticError
    │   └── DivisionByZeroError
    ├── CompileError
    │   └── ParseError
    └── ValueError (PHP 8.0 新增)

• Exception：用于处理业务逻辑或可恢复的运行时问题（如：数据库连接失败、用户输入验证失败、文件未找到），通常我们应该主动 try...catch 它们。
• Error：用于处理PHP引擎层面的严重错误，很多是不可恢复或不应该被捕获的（如：内存耗尽、类不存在、类型不匹配），但在某些场景下（如框架的优雅降级），捕获 Error 是有意义的。

为什么要区分 Exception 和 Error？

核心原则：不要用 Exception 处理引擎错误，反之亦然。Error 代表程序有 bug（如：类型不对、参数不够），需要修复代码；Exception 代表外部条件异常（如：网络超时、机器人撞墙）,需要处理流程。

在项目中的正确实践

✅ 好的做法：捕获 Throwable 用于全局兜底

在框架的入口文件（如 index.php）或全局异常处理器中，捕获 Throwable 可以防止任何未被捕获的崩溃暴露给用户。

<?php
// 全局异常/错误处理器
set_exception_handler(function (Throwable $throwable) {
    // 1. 记录所有错误和异常到日志
    error_log(sprintf(
        "[%s] %s in %s:%d\n%s",
        get_class($throwable),
        $throwable->getMessage(),
        $throwable->getFile(),
        $throwable->getLine(),
        $throwable->getTraceAsString()
    ));
    // 2. 根据环境决定响应
    if (getenv('APP_ENV') === 'production') {
        echo "服务发生不可预期的错误，请稍后再试。";
        // 发送 500 状态码
        http_response_code(500);
    } else {
        // 开发环境显示详细错误（不推荐在生产使用）
        echo "<pre>" . $throwable . "</pre>";
    }
});
// 这会触发一个 "TypeError"（属于 Error 家族）
function add(int $a, int $b): int {
    return $a + $b;
}
try {
    add('hello', 10);
} catch (TypeError $e) {
    // 主动捕获 TypeError：这次我们选择优雅处理
    echo "类型错误：需要整数参数";
} catch (Throwable $e) {
    // 兜底：捕获所有其他 Throwable（包括其他 Error 和 Exception）
    echo "其他错误：". $e->getMessage();
}

✅ 好的做法：捕获特定 Exception 处理业务逻辑

<?php
class DatabaseConnectionException extends Exception {}
function connectDatabase(): PDO {
    throw new DatabaseConnectionException("数据库连接超时");
}
try {
    $pdo = connectDatabase();
} catch (DatabaseConnectionException $e) {
    // 具体处理：重试或切换备用数据库
    echo "数据库有问题，尝试备用...";
    // $pdo = connectBackupDatabase();
} catch (Exception $e) {
    // 捕获其他所有 Exception（如 PDOException）
    echo "数据库其他错误: " . $e->getMessage();
}

❌ 糟糕的做法：滥用 catch (Throwable $e) 到处捕获

<?php
// 反面教材：在业务逻辑层到处 catch Throwable
function processUserData(array $data): void {
    try {
        // 这行代码如果 user_id 不存在，会触发 ValueError (PHP 8+)
        $id = intval($data['user_id']);
        // 这里如果 user 类不存在，会触发 Error
        $user = new User();
    } catch (Throwable $e) {
        // 吞掉所有的错误！
        // User 类真的不存在，程序应该崩溃报警，而不是静默失败
        echo "处理失败";
    }
}

为什么不好？ 如果你在业务代码中捕获 Throwable，会掩盖代码中的 真正 bug（如：调用不存在的类、类型错误、除以零），这些 bug 应该通过崩溃暴露出来，迫使开发者修复,而不是被静默吞掉。

实战建议汇总

PHP 8 的进步与注意点

• ValueError (PHP 8.0)：当传递的值正确但不在有效范围内时抛出（如 array_rand([1,2], 0)），它属于 Error,意味着这种问题通常是不可恢复的编程错误。
• TypeError 变得更严格：PHP 8 对类型错误更严格，这属于 Error，应该通过修复代码解决，而不是 catch 掉。

• Throwable：统一了 Exception 和 Error 的顶层接口。
• Exception：处理业务逻辑异常，你应该主动 try...catch 它们。
• Error：处理引擎系统错误，你应该避免在业务代码中 catch 它们,除非是在全局兜底处。
• 黄金法则：只捕获你预期会发生且你能合理处理的错误，其余让引擎崩溃，然后由全局处理器兜底记录。