Laravel PHPUnit测试：如何一次性迁移并填充测试数据库？

你的代码问题在于直接在类主体中调用Artisan::call，这是PHP语法错误——类的主体只能定义属性、方法，不能直接执行代码逻辑。要实现所有测试执行前仅运行一次数据库刷新与填充，按以下步骤操作：

正确实现方式 #

1. 移除RefreshDatabase trait（该trait默认会在每个测试方法执行时重置数据库，与“一次性执行”的需求冲突）
2. 使用PHPUnit的setUpBeforeClass静态方法，该方法会在当前测试类的所有测试方法执行前运行一次
3. 在方法内初始化Laravel应用实例，确保Artisan命令能正常执行

修改后的TestCase代码：

<?php

namespace Tests;

use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
use Illuminate\Support\Facades\Artisan;

abstract class TestCase extends BaseTestCase
{
    /**
     * 所有测试方法执行前仅运行一次
     */
    public static function setUpBeforeClass(): void
    {
        parent::setUpBeforeClass();

        // 初始化Laravel应用
        $app = static::createApplication();
        $app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();

        // 刷新数据库（删除所有表并重新迁移）
        Artisan::call('migrate:fresh');
        // 执行数据填充
        Artisan::call('db:seed');
    }
}

补充说明 #

• 如果需要整个测试套件全局仅执行一次（而非每个测试类执行一次），可以在phpunit.xml中配置自定义bootstrap文件，在bootstrap里执行迁移和填充逻辑
• 这种一次性初始化的方式会导致测试之间共享数据库状态，可能影响测试独立性。如果你的测试需要隔离环境，建议还是使用RefreshDatabase trait配合测试数据工厂来保证每个测试的纯净性

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