在 Laravel 应用开发中，异常处理和日志记录是排查问题的关键环节。当异常发生并被捕获后，有时我们会创建新的异常，并将其与原始异常链接起来（即链式异常），以添加更多上下文信息。例如：
<?php
// 应用入口点
method1();
function method1()
{
try {
method2();
} catch (\Exception $e) {
// 在 Monolog 1.x 日志中，默认输出的堆栈追踪是这个异常的，
// 但这对于定位原始错误源帮助不大。
throw new \Exception('调用 method1 失败，因为出现问题', $e->getCode(), $e);
}
}
function method2()
{
try {
method3();
} catch (\Exception $e) {
throw new \Exception('调用 method2 失败，因为出现问题', $e->getCode(), $e);
}
}
function method3()
{
// 我们希望在日志中看到这个原始异常的堆栈追踪，
// 甚至更好是所有链中异常的合并堆栈追踪。
throw new \Exception('噢，出错了！');
}上述代码演示了一个典型的链式异常场景：method3 抛出原始异常，method2 捕获并包装，method1 再次捕获并包装。在 Laravel 的控制台输出中，nunomaduro/collision 包能够智能地合并并显示所有链式异常的堆栈追踪，提供极佳的调试体验。然而，当这些异常被 Monolog 记录到日志文件时，默认行为却往往只输出链中“最新”抛出的异常（即 method1 中包装的异常）的堆栈追踪，而忽略了原始异常的堆栈信息，这极大地增加了问题排查的难度。
Monolog 1.x 中的问题根源
经过深入分析，该问题主要源于 Monolog 1.x 版本中的 LineFormatter 的局限性。LineFormatter 在处理异常时，默认情况下未能递归地获取并格式化链式异常（通过 getPrevious() 方法获取）的堆栈追踪。这意味着虽然日志中可能会显示所有链式异常的消息，但堆栈追踪信息却是不完整的，仅限于链条的顶端异常。值得注意的是，Monolog 1.x 的其他一些格式化器通常不会有此问题。
解决方案一：升级 Monolog 到 2.x
最直接且推荐的解决方案是将项目中的 Monolog 库升级到 2.x 或更高版本。Monolog 2.x 在其 LineFormatter 中已经解决了这一问题，通过相关的 Pull Request (例如 #1170)，LineFormatter 能够正确地遍历链式异常并输出完整的堆栈追踪信息。
Laravel 6.x 及更高版本是完全兼容 Monolog 2.x 的。要进行升级，您只需通过 Composer 更新您的依赖：
composer require monolog/monolog:^2.0 composer update
执行此命令后，Composer 将会升级 Monolog 及其相关依赖。升级完成后，您的 Laravel 应用在记录链式异常时，Monolog 将会自动输出包含所有链式异常的完整堆栈追踪，极大地提升日志的可用性。
解决方案二：Monolog 1.x 的替代方案
如果您由于某些兼容性原因，暂时无法将 Monolog 升级到 2.x 版本，那么可以考虑以下两种替代方案来解决 Monolog 1.x 的堆栈追踪问题：
1. 使用不同的 Monolog 内置格式化器
Monolog 提供了多种内置的格式化器，例如 HtmlFormatter 或 JsonFormatter。这些格式化器在处理异常时，可能比 LineFormatter 更完整地包含链式异常信息。
您可以在 config/logging.php 配置文件中，为您的日志通道指定不同的格式化器。例如，切换到 JsonFormatter：
// config/logging.php
'channels' => [
'stack' => [
'driver' => 'stack',
'channels' => ['single'],
'ignore_exceptions' => false,
],
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
// 'formatter' => Monolog\Formatter\LineFormatter::class, // 默认的 LineFormatter
'formatter' => Monolog\Formatter\JsonFormatter::class, // 切换到 JsonFormatter
'formatter_with' => [
'prettyPrint' => true, // 如果是 JsonFormatter，可以设置美化输出
],
],
// ... 其他通道
],使用 JsonFormatter 后，日志将以 JSON 格式输出，其中异常信息通常会包含一个结构化的 exception 字段，该字段可能包含 previous 字段，从而能够递归地展现链式异常的详细信息，包括堆栈追踪。
2. 自定义 Monolog 格式化器
如果内置格式化器无法满足您的特定需求，或者您希望在 Monolog 1.x 环境下保留 LineFormatter 的基本样式，但又需要完整的链式堆栈追踪，您可以创建一个自定义的 Monolog 格式化器。这个自定义格式化器可以继承 Monolog\Formatter\LineFormatter，并重写其 format 方法，以递归地处理链式异常并将其堆栈追踪合并到输出中。
创建自定义格式化器示例 (概念性代码):
// app/Logging/Formatters/CustomLineFormatter.php
<?php
namespace App\Logging\Formatters;
use Monolog\Formatter\LineFormatter;
use Throwable;
class CustomLineFormatter extends LineFormatter
{
/**
* 格式化日志记录
*
* @param array $record
* @return string
*/
public function format(array $record): string
{
// 调用父类的 format 方法获取基本格式化字符串
$output = parent::format($record);
// 检查是否存在异常，并递归处理链式异常
if (isset($record['context']['exception']) && $record['context']['exception'] instanceof Throwable) {
$exception = $record['context']['exception'];
$fullStackTrace = $this->getFullStackTrace($exception);
// 将完整的堆栈追踪插入到输出中。
// 这里我们尝试替换或追加，具体逻辑可根据需求调整
$originalTraceString = $exception->getTraceAsString();
if (strpos($output, $originalTraceString) !== false) {
$output = str_replace($originalTraceString, $fullStackTrace, $output);
} else {
// 如果原始堆栈未被 LineFormatter 包含，则直接追加
$output .= "\n" . $fullStackTrace;
}
}
return $output;
}
/**
* 递归获取所有链式异常的堆栈追踪字符串
*
* @param Throwable $e
* @return string
*/
protected function getFullStackTrace(Throwable $e): string
{
$trace = '';
$i = 0;
do {
$trace .= sprintf(
"#%d %s: %s in %s:%d\n%s\n",
$i++,
get_class($e),
$e->getMessage(),
$e->getFile(),
$e->getLine(),
$e->getTraceAsString()
);
$e = $e 
