从SQLite切换到MySQL后Laravel多数测试失败求助排查

问题根源分析 #

你遇到的问题核心是**RefreshDatabase trait在MySQL与SQLite下的重置逻辑差异**：

• SQLite内存库会在每次测试前完全重建数据库，种子数据会被重新填充；
• MySQL环境下，RefreshDatabase默认用事务回滚实现数据库重置（而非重建），如果你的测试类setUp方法或种子类逻辑有问题，会导致后续测试的依赖数据（如roles表）缺失。

结合你的报错，大概率是以下两种情况之一：

1. 自定义setUp方法未触发RefreshDatabase的重置逻辑，导致第一个测试的数据残留，后续种子执行失败；
2. 种子类未处理重复数据，首次测试后roles表已有数据，后续种子因唯一约束报错终止，导致roles表无可用数据。

解决方案 #

方案1：修复setUp方法的执行顺序

你的测试类自定义了setUp方法，但必须先调用父类的setUp，确保RefreshDatabase的事务/重置逻辑先执行：

protected function setUp(): void
{
    parent::setUp(); // 必须放在最前面，启动RefreshDatabase的重置流程

    $this->seed();
}

这样每次测试前，数据库会先被重置（事务启动或迁移刷新），再执行种子填充，测试结束后事务回滚，数据库回到干净状态。

方案2：修改种子类避免重复插入报错

在RoleSeeder中用firstOrCreate替代直接create/insert，确保即使数据库已有角色数据，种子执行也不会中断：

// database/seeders/RoleSeeder.php
public function run()
{
    // 示例：确保admin角色存在，不存在则创建
    Role::firstOrCreate(
        ['name' => 'admin'], // 唯一查询条件
        ['display_name' => '管理员', 'description' => '系统管理员'] // 新增时的字段
    );

    // 其他角色同理处理
}

方案3：强制使用迁移刷新模式（可选）

如果事务回滚模式不满足需求，可强制RefreshDatabase每次测试前完全重建数据库：

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Contracts\Console\Kernel;

class YourTest extends TestCase
{
    use RefreshDatabase;

    protected function refreshTestDatabase()
    {
        if (! RefreshDatabase::shouldRefreshDatabase()) {
            return;
        }

        $this->artisan('migrate:fresh');
        $this->artisan('db:seed');

        $this->app[Kernel::class]->setArtisan(null);
    }

    // 你的测试方法...
}

注意：此方式会降低测试速度，但能确保数据库绝对干净。

额外排查步骤 #

1. 检查phpunit.xml中的DB_HOST/DB_DATABASE配置，确认测试环境连接的是独立的testdb容器；
2. 单独运行一个失败的测试，查看testdb的roles表是否为空，确认种子是否执行失败；
3. 查看测试日志，是否有种子执行时的唯一约束报错（该报错可能被外键错误掩盖）。

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