Laravel 11 Pest测试beforeAll方法出现'A facade root has not been set'错误

问题根源 #

beforeAll 是在测试类加载阶段就执行的钩子，此时Laravel的应用容器还未完成初始化。而Artisan、Http这类Facade必须依赖容器的根实例才能工作，所以会抛出"A facade root has not been set"错误。相比之下，beforeEach是在每个测试用例执行前触发，此时Laravel已经完成了应用初始化流程，因此可以正常调用Facade。

解决方案 #

方法一：在beforeAll中手动初始化Laravel应用

直接在beforeAll钩子中启动Laravel应用，为Facade提供所需的容器实例：

beforeAll(function () {
    // 加载并初始化Laravel应用
    $app = require __DIR__.'/../bootstrap/app.php';
    $app->make(Illuminate\Contracts\Console\Kernel::class)->bootstrap();

    // 此时可正常调用Facade
    Artisan::call('db:seed');
});

如果你的测试类已经继承了Tests\TestCase，也可以通过实例化TestCase来启动应用：

beforeAll(function () {
    $testCase = new Tests\TestCase();
    $testCase->createApplication();

    Artisan::call('db:seed');
});

方法二：改用Pest的setup钩子（推荐）

Pest的setup钩子会在应用初始化完成后执行，无需手动启动应用，更符合Laravel测试的生命周期：

// 在测试文件顶部引入TestCase并绑定setup钩子
uses(Tests\TestCase::class)->setup(function () {
    // 这里的代码会在所有测试前执行，且应用已初始化
    Artisan::call('db:seed');
})->in(__DIR__);

额外提示 #

如果只是需要执行数据库填充，也可以考虑在Tests\TestCase中设置protected $seed = true，或者在测试类中直接调用$this->seed()方法，但如果必须在所有测试前仅执行一次填充，上述两种方法更合适。

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