优化 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('噢，出错了！');
}

composer require monolog/monolog:^2.0
composer update

// 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，可以设置美化输出
        ],
    ],

    // ... 其他通道
],

// 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