Laravel Pest如何仅为单个测试刷新数据库？

我在Laravel项目中用Pest写测试时遇到一个问题：同一个测试文件里有三个测试用例，只有第三个需要操作数据库。为了节省测试执行时间，我没有在文件顶部全局使用uses(RefreshDatabase::class);，而是单独给第三个测试用例链式调用了这个方法，但重复运行测试时，前一次的测试数据没有被清除，导致断言失败。

测试代码 #

// 注释掉全局的RefreshDatabase
// uses(RefreshDatabase::class);

it('test 1', function () {
    // 无数据库操作
});

it('test 2', function () {
    // 无数据库操作
});

it('successfully stores social connector', function () {
    $repo->storeSocialConnector(["platform"=>"wix"]); // 假设成功向social_connectors表插入数据

    $this->assertDatabaseHas('social_connectors', [
        'platform' => 'fooBar',
    ]);

})->uses(RefreshDatabase::class);

重复运行后的失败输出 #

FAILED  Tests\Feature\Http\SomeTest > it successfully stores social connector
  Failed asserting that a row in the table [social_connectors] matches the attributes {
    "platform": "fooBar"
}.

Found: [
    {
        "platform": "wix",
    },
    {
        "platform": "wix",
    }
].

解决方法 #

1. 替换为DatabaseTransactions trait

RefreshDatabase会在测试前重建数据库，而DatabaseTransactions是在测试结束后回滚事务，速度更快，且能保证测试后数据被清理，适合单个测试用例的场景：

it('successfully stores social connector', function () {
    $repo->storeSocialConnector(["platform"=>"wix"]);

    $this->assertDatabaseHas('social_connectors', [
        'platform' => 'fooBar',
    ]);

})->uses(DatabaseTransactions::class);

2. 手动在测试后清理数据

如果不想用框架提供的trait，可以在测试内部添加afterEach钩子手动清空表：

it('successfully stores social connector', function () {
    $repo->storeSocialConnector(["platform"=>"wix"]);

    $this->assertDatabaseHas('social_connectors', [
        'platform' => 'fooBar',
    ]);

})->afterEach(function () {
    \Illuminate\Support\Facades\DB::table('social_connectors')->truncate();
});

3. 检查版本兼容性

部分旧版本的Pest在单个测试用例绑定RefreshDatabase时存在生命周期问题，确保你的Laravel和Pest版本是最新兼容的（比如Laravel 10+搭配Pest 2.x）。

4. 确认测试隔离性

检查是否有其他全局测试钩子（比如TestCase类中的全局设置）影响了数据库状态，确保单个测试用例的数据库操作是完全隔离的。

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