catch (Throwable $e) 是 PHP 8.3 唯一能同时捕获 Exception 和 Error 类（如 TypeError、ValueError）的兜底方式，因所有可抛出对象均实现 Throwable 接口，且自 PHP 7.0 起已存在。
PHP 8.3 中 Throwable 接口不是“使用”的新功能，而是早已存在的统一基接口（自 PHP 7.0 起），你只需按规范捕获它即可实现真正兜底——但很多人写 catch (Throwable $e) 后仍漏掉关键细节，导致日志丢失、错误静默或生产环境暴露敏感信息。
为什么 catch (Throwable $e) 在 PHP 8.3 仍是首选兜底方式
PHP 8.3 没改变 Throwable 的语义，但强化了类型系统和错误报告精度。所有可抛出对象（Exception、Error 及其全部子类，如 TypeError、ParseError、UnhandledMatchError）都实现该接口。这意味着：
-
catch (Exception $e)会漏掉Error类（比如函数参数类型不匹配触发的TypeError） -
catch (Throwable $e)是唯一能同时覆盖业务异常与引擎错误的写法 - PHP 8.3 中新增的
ValueError（如json_decode('', true, 512, JSON_THROW_ON_ERROR)失败时抛出）也实现Throwable，无需额外适配
常见错误：在 try-catch 里只写 Exception 还没意识到问题
这种写法在 PHP 8.3 下极易引发静默失败：
try {
$data = json_decode($input, flags: JSON_THROW_ON_ERROR);
} catch (Exception $e) {
// ❌ TypeError / ValueError 不会进这里！脚本直接 fatal error
logError($e);
}
正确做法是显式降级兼容：
立即学习“PHP免费学习笔记（深入）”；
- 优先用
catch (Throwable $e)替代catch (Exception $e) - 若需区分处理，先
catch具体子类，最后用catch (Throwable $e)收尾 - 不要依赖
@抑制错误——PHP 8.3 中@对大多数Error无效，且会禁用 JIT 优化
set_exception_handler 必须接收 Throwable，否则会报错
PHP 8.3 强制要求全局异常处理器签名必须接受 Throwable，传 Exception 会导致 Fatal error: Uncaught TypeError：
// ❌ PHP 8.3 下运行时报错
set_exception_handler(function (Exception $e) { ... });
<p>// ✅ 正确写法（注意类型声明）
set_exception_handler(function (Throwable $e): void {
error_log('Uncaught: ' . $e::class . ' - ' . $e->getMessage());
http_response_code(500);
echo 'Service unavailable';
});
还要注意：
- 该 handler 不捕获
ParseError（语法错误）和Fatal Error（如内存耗尽），它们发生在脚本加载/执行初期，需靠register_shutdown_function()+error_get_last()补充 - handler 执行完后脚本终止，不能
return或试图恢复执行 - 若 handler 内部再抛异常，PHP 直接中止并输出致命错误，无法二次捕获
自定义异常类必须继承 Exception，不能直接实现 Throwable
虽然 Throwable 是接口，但 PHP 禁止用户直接 implements Throwable —— 这是语言硬性限制，违反会触发 Compile Error：
// ❌ 编译失败：Cannot implement interface Throwable
class MyError implements Throwable { ... }
<p>// ✅ 正确：继承 Exception（或 Error，但 Error 应留给引擎内部使用）
class ValidationException extends Exception { ... }
实际开发中应：
- 业务异常一律继承
Exception，保持语义清晰 - 避免重写
__construct()时漏传$previous参数，否则异常链断裂，上游无法获取原始上下文 - 若需携带额外字段（如错误码），在构造函数中保存，并提供 getter 方法，不要覆盖父类关键行为
最常被忽略的一点：PHP 8.3 的 TypeError 和 ValueError 默认不带完整调用栈（尤其在 JIT 启用时），若依赖堆栈定位问题，务必在 catch (Throwable $e) 中显式调用 $e->getTraceAsString() 并记录到日志，而不是只记 $e->getMessage()。
