PHP 错误处理怎样保留原始异常链

PHP 错误处理要保留原始异常链，关键不是把底层异常的消息拼接到新字符串里，而是在创建上层异常时把原来的 Throwable 传给构造函数第三个参数 $previous。这样日志可以从当前业务异常一路回到最初原因，对外响应仍可以只返回安全的业务提示。

官方资料：https://www.php.net/manual/en/exception.construct.php

跨层转换时使用 new DomainException($message, $code, $previous)；捕获最外层异常后，用 getPrevious() 循环向下读取。不要用字符串拼接代替链式关系，也不要把完整内部堆栈直接返回给用户。

• 同一层补充上下文：可以继续抛出原异常对象，保留原类型和堆栈。
• 跨层改变语义：创建新的业务异常，并把旧的 Throwable 放进 $previous。
• 记录链条：从最外层开始记录消息、类型、文件和行号，再沿 getPrevious() 继续。

先判断应该重新抛出还是包装

异常链通常出现在“底层组件失败，但上层需要换一种业务语言”的位置。比如数据库驱动抛出连接异常，仓储层可以包装成“读取订单失败”；原异常仍然保留，日志才不会只剩一句泛化提示。

如果当前层只是增加日志、清理资源或把异常继续交给更高层，直接 throw;（PHP 中通常写作 throw $e;）即可。只有当异常的语义、责任边界或对调用方的处理方式发生变化时，才创建新的异常并传入 $previous。

用 $previous 保留底层原因

Exception::__construct() 的第三个参数就是用于异常链的 $previous。下面的示例只在跨层时替换异常类型，底层异常对象不被改写；代码中的中文注释说明了包装点和记录边界。

prepare('SELECT id, status FROM orders WHERE id = :id');
        $statement->execute(['id' => $orderId]);
        $order = $statement->fetch(PDO::FETCH_ASSOC);
        if ($order === false) {
            throw new RuntimeException('订单不存在');
        }
        return $order;
    } catch (Throwable $e) {
        // 改变异常语义，但把旧 Throwable 放入第三个参数，保留原始链。
        throw new OrderReadException('读取订单失败', 0, $e);
    }
}

try {
    $order = loadOrder($pdo, 1001);
} catch (OrderReadException $e) {
    // 对外只给稳定提示；完整链条应写入受控日志。
    error_log($e->getMessage() . ' | 原因：' . ($e->getPrevious()?->getMessage() ?? '无'));
    echo '订单暂时无法读取';
}

这里的重点是对象关系，不是把上一层消息拼进新消息。调用 $e->getPrevious() 可以拿到被包装的 Throwable；如果没有上一层，返回值就是 null。

怎样从最外层读完整异常链

日志系统一般需要知道“当前业务语义”和“最初技术原因”。可以从外层开始循环，每次先记录当前节点，再把变量移动到 getPrevious() 返回的对象。链的方向是由当前异常指向上一层原因，不要假设所有异常都会自动形成链。

 $current::class,
            'message' => $current->getMessage(),
            'file' => $current->getFile(),
            'line' => $current->getLine(),
        ];
        // 没有 previous 时返回 null，循环自然结束。
        $current = $current->getPrevious();
    }
    return $items;
}

实际项目可以把 exceptionChain() 的结果交给结构化日志。对外响应只返回稳定错误码或通用提示；日志侧再按权限保存类型、消息、文件和行号，避免把数据库表名、路径和配置细节泄露给访客。

三种处理方式怎么选

最后检查三点：包装异常的第三个参数是否真的传入原始 Throwable；日志是否从外层遍历到 null；响应层是否把内部链条与用户可见信息分开。满足这三点，异常链既能帮助定位根因，也不会把实现细节带出服务边界。

PHP 异常链常见问题

只改异常消息能保留原始异常吗？

不能。字符串拼接只能生成一段新文本，无法保留原异常的类型、文件、行号和堆栈。需要换异常类型时，应把旧对象作为 $previous 传入。

getPrevious() 什么时候返回 null？

当前异常没有通过异常构造函数的第三个参数连接上一层时，会返回 null。遍历时用 while ($current !== null) 作为结束条件即可。

要不要把完整异常链返回给前端？

通常不应该。前端拿稳定错误码和可理解的提示，完整链条交给受控日志或诊断系统；这样既保留排障信息，也减少路径、SQL 或内部组件信息泄露。