PEST PHP中afterAll钩子无法执行数据库清理操作的问题

我尝试用PEST PHP的afterAll钩子清理数据库记录，但始终无法生效。测试代码如下：

it('can signup', function()
{
    $response = $this->post(route('signup'), [.....]);
    
    expect($response->status())->toBe(200);
});

it('can signup as existing user', function()
{
    $user = User::findOrFail(1);
    
    $response = $this->actingAs($user)->post(route('signup'), [.....]);
    
    expect($response->status())->toBe(200);
});

afterAll(function()
{
    \App\Models\PlansSignups::where('user_id', 1)->delete(); // 此代码确认被调用，但无效果
});

通过XDebug确认afterAll函数已被调用，但其中的数据库查询始终未生效。但将相同查询放到测试用例内部执行时却能正常工作：

it('can signup as existing user', function()
{
    $user = User::findOrFail(1);
    
    $response = $this->actingAs($user)->post(route('signup'), [.....]);
    
    expect($response->status())->toBe(200);
    
    \App\Models\PlansSignups::where('user_id', 1)->delete(); // 执行正常
});

原因分析 #

核心问题出在Laravel测试的事务机制上：

• Laravel默认会给每个测试用例启动一个独立的数据库事务，测试执行完成后自动回滚事务，以此保证测试之间的隔离性。
• PEST的afterAll钩子是在所有测试用例执行完毕、且所有测试的事务都已回滚之后才运行的。这意味着你在测试中创建的PlansSignups记录已经被事务回滚删除了，此时afterAll中的delete语句找不到任何符合条件的记录，自然看起来像是“未执行”。
• 而在测试用例内部执行delete时，是在当前测试的事务还未回滚的阶段，此时记录仍然存在，所以查询能正常生效。

解决办法 #

根据测试需求，有几种可行的方案：

1. 利用Laravel自动事务回滚，无需手动清理

如果你的测试仅需要保证数据隔离，完全不需要手动调用delete——Laravel的事务回滚会自动清除每个测试产生的数据，这也是官方推荐的测试方式。

2. 使用RefreshDatabase trait替代事务隔离

如果需要在afterAll中操作持久化的数据，可以在测试类中使用RefreshDatabase trait：

uses(\Illuminate\Foundation\Testing\RefreshDatabase::class);

// ... 测试用例和afterAll钩子

这个trait会在测试前重新迁移数据库，测试后重置数据库，所有测试数据都是持久化的，afterAll中的查询就能正常找到并删除记录。

3. 使用afterEach钩子替代afterAll

如果需要在每个测试完成后清理数据，改用afterEach钩子，它会在每个测试用例的事务回滚前执行：

afterEach(function()
{
    \App\Models\PlansSignups::where('user_id', 1)->delete();
});

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