测试中Artisan命令未同步执行的原因排查

问题分析 #

从你描述的现象来看，核心矛盾是命令实际已完成数据库修改，但测试断言却先于命令执行完成，结合代码细节，可能的原因集中在以下几点：

• Artisan测试命令的执行时机延迟
• Tenant::merge()内部隐含异步队列逻辑
• 测试事务的隔离性导致断言无法读取未提交的修改

解决方案 #

1. 确保断言在命令执行完成后触发

Laravel的PendingCommand提供了then()回调，会在命令执行完毕后触发，可将断言逻辑放入其中，强制执行顺序：

$this->artisan('tools:merge')
    ->expectsSearch(
        question: 'Select a tenant',
        answer: self::$tenantId,
        search: 'test',
        answers: Tenant::all()->pluck('name', 'id')->toArray()
    )
    ->assertExitCode(0)
    ->then(function () {
        dump(microtime(), Tenant::count());
        $this->assertDatabaseHas('tenants', ['id' => self::$tenant->id]);
    });

2. 手动触发命令执行

显式调用run()或execute()方法，避免链式调用的延迟执行问题：

$command = $this->artisan('tools:merge')
    ->expectsSearch(
        question: 'Select a tenant',
        answer: self::$tenantId,
        search: 'test',
        answers: Tenant::all()->pluck('name', 'id')->toArray()
    );

// 手动执行命令并获取退出码
$exitCode = $command->run();

$this->assertEquals(0, $exitCode);
dump(microtime(), Tenant::count());
$this->assertDatabaseHas('tenants', ['id' => self::$tenant->id]);

3. 排查异步队列逻辑

如果Tenant::merge()内部触发了队列任务，数据库修改会在异步进程中执行，此时测试断言会早于队列完成：

// 若不需要实际执行队列，先模拟队列
Queue::fake();

$this->artisan('tools:merge')
    ->expectsSearch(...)
    ->assertExitCode(0);

// 验证队列任务是否被触发
Queue::assertPushed(MergeTenantJob::class);

// 若需要实际执行队列任务以验证数据库修改
Queue::assertPushed(MergeTenantJob::class, function ($job) {
    $job->handle();
    return true;
});

$this->assertDatabaseHas('tenants', ['id' => self::$tenant->id]);

4. 检查事务一致性

若测试使用了DatabaseTransactions trait，确保命令中没有手动提交事务（比如DB::commit()），否则会导致测试事务与命令事务隔离，断言无法读取修改：

// 移除命令中手动提交事务的代码，由测试框架统一管理事务
// 例如：删除 DB::commit(); 或 DB::endTransaction();

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