深入理解 PHP 的异常链（Exception Chaining）：保留原始错误上下文的调试技巧-php教程-PHP中文网

php异常链必须用throw new exception from $e显式构建，否则原始异常堆栈丢失；__cause__仅在此语法下非null，日志与监控需专门配置才支持链式上下文。

深入理解 php 的异常链（exception chaining）：保留原始错误上下文的调试技巧

PHP 的异常链不是可选项，而是调试时必须打开的“错误探照灯”——不用 throw new Exception from $e，你就主动丢掉了最关键的原始错误线索。

为什么 `throw new Exception from $e` 比 `throw new Exception` 多出一倍调试价值

原始异常（比如 TypeError 或 PDOException）一旦被简单覆盖，堆栈就断了。PHP 不会自动把旧异常塞进新异常里；它只在你显式用 from 时才建立链路。

$e->__cause__ 只有在用了 from 才非空，否则为 null
$e->getTraceAsString() 显示的是新异常抛出处，而 $e->__cause__->getTraceAsString() 才是原始出错点
日志系统（如 Monolog）默认只记录当前异常，但若配置了 include_cause: true，就能连带输出原始上下文

PHP 7+ 中 `from` 的实际写法与常见误用

语法看着简单，但几个细节不注意就会让链路失效：

必须是 throw NewException from $originalException，不能写成 throw NewException("msg", 0, $originalException) —— 后者是 PHP 5 风格构造器传参，PHP 7+ 已废弃且不触发链路
$originalException 必须是 Throwable 实例，不能是字符串或数组；传错会报 Fatal error: Uncaught TypeError
如果在 catch 块外使用 from（比如直接 throw 一个没被捕获过的原始异常），__cause__ 仍为 null，因为没有“原始异常”可链

正确示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

try {
    $pdo->query("SELECT * FROM nonexist");
} catch (PDOException $e) {
    throw new RuntimeException("数据库查询失败", 500) from $e;
}

自定义异常类如何安全继承异常链

自定义类本身不破坏链路，但构造逻辑容易出错：

不要在自定义异常的 __construct() 里手动赋值 $this->previous = $e —— 这绕过了 PHP 内部链路机制，__cause__ 仍是 null
应该调用父类构造器： parent::__construct($message, $code, $previous)，其中 $previous 就是传入的原始异常
若想默认支持链路，构造器参数应兼容 Throwable $previous = null，并透传给父类

推荐写法：

class DataProcessingException extends RuntimeException
{
    public function __construct(string $message, int $code = 0, Throwable $previous = null)
    {
        parent::__construct($message, $code, $previous);
    }
}

异常链在日志和监控中的真实落地难点

链路建好了，不代表能被观测到——很多日志组件默认只打最外层异常：

Monolog 的 LineFormatter 默认不展开 __cause__，需手动调用 $record['context']['cause'] = $e->__cause__ 并在 formatter 中处理
Sentry PHP SDK 从 v4.0 起才原生支持异常链上传，旧版本需启用 send_default_pii: true 并手动注入 exception.cause
error_log() 函数完全不识别异常链，直接 error_log($e) 只输出当前异常，必须自己拼接 $e->__cause__ ?? ''