Laravel 8中PHPUnit测试时自定义异常栈信息污染控制台的问题及解决方法

1. 该异常栈信息输出至控制台是否为预期行为？ #

不是预期行为。你已经通过renderable方法为自定义异常配置了正确的HTTP响应返回逻辑，但控制台仍输出异常栈的原因是：Laravel的异常处理分为渲染响应和日志上报两个独立流程——你只处理了前者，而默认的reportable逻辑依然会将所有未被排除的异常记录到日志中，测试环境下日志通常直接输出到控制台，因此你看到了完整的调用栈。

2. 如何隐藏这些输出内容？ #

有三种针对性的解决方案，按推荐优先级排序：

方案一：在Handler中为自定义异常添加忽略上报逻辑

直接在app/Exceptions/Handler.php的register方法里，为MyCustomNotFoundException添加reportable回调，返回false即可阻止该异常被记录日志：

public function register() {
    $this->reportable(function (Throwable $e) {
        // 其他异常的上报逻辑（如果有的话）
    });

    // 忽略自定义404异常的日志上报
    $this->reportable(function (MyCustomNotFoundException $exception) {
        return false;
    });

    $this->renderable(function (MyCustomNotFoundException $exception) {
        return response()->json(['error' => $exception->getMessage()], 404);
    });
}

方案二：在自定义异常类中实现shouldReport方法

如果希望这个异常在全局范围内都不被记录日志，可以在MyCustomNotFoundException类中重写shouldReport方法，返回false：

namespace App\Exceptions;

use Exception;

class MyCustomNotFoundException extends Exception
{
    // ... 你的异常构造方法或其他逻辑

    /**
     * 决定是否应该将此异常上报到日志
     *
     * @return bool
     */
    public function shouldReport()
    {
        return false;
    }
}

方案三：调整测试环境的日志配置（全局生效）

如果希望测试环境下完全关闭日志输出，或者只记录严重错误，可以修改日志配置：

1. 在config/logging.php的channels数组中添加测试专用通道：

'channels' => [
    // ... 其他通道
    'testing' => [
        'driver' => 'null', // 不记录任何日志
    ],
],

2. 在.env.testing文件中设置日志通道为该测试通道：

LOG_CHANNEL=testing

注意：此方案会全局关闭测试环境的所有日志输出，可能会错过其他重要异常的排查信息，因此仅推荐在明确不需要测试日志的场景使用。

内容的提问来源于stack exchange，提问作者Adam