Laravel 8压缩迁移后测试数据库无法正常初始化问题求助

问题原因 #

Laravel 8的DatabaseMigrations/RefreshDatabase等测试trait默认不会自动识别并加载schema dump文件，且手动调用migrate命令时，若测试数据库已存在空的migrations表，命令会认为无需执行结构初始化，导致schema dump未被导入。

解决方案 #

1. 给测试数据库连接添加schema_dump配置 #

在config/database.php的testing连接配置中，加入schema dump的路径配置，让测试环境能识别到dump文件：

'testing' => [
    'driver' => 'mysql',
    'host' => env('DB_TEST_HOST', '127.0.0.1'),
    'port' => env('DB_TEST_PORT', '3306'),
    'database' => env('DB_TEST_DATABASE', 'forge'),
    'username' => env('DB_TEST_USERNAME', 'forge'),
    'password' => env('DB_TEST_PASSWORD', ''),
    // 新增schema_dump配置
    'schema_dump' => [
        'path' => database_path('schema/mysql-schema.dump'),
    ],
],

2. 替换测试初始化逻辑，使用migrate:fresh导入schema dump #

放弃原有的DatabaseMigrations trait，改用手动调用migrate:fresh命令（该命令会先清空数据库所有表，再从schema dump重建结构），可以自定义一个测试trait复用逻辑：

创建Tests/Traits/UsesSchemaDump.php：

<?php

namespace Tests\Traits;

use Illuminate\Support\Facades\Artisan;

trait UsesSchemaDump
{
    protected function setUp(): void
    {
        parent::setUp();

        // 清空测试数据库并从schema dump重建结构
        Artisan::call('migrate:fresh', [
            '--database' => 'testing',
            '--force' => true,
        ]);
    }
}

然后在测试类中使用这个trait：

class SystemControllerTest extends TestCase
{
    use WithFaker;
    use Tests\Traits\UsesSchemaDump;

    private $user;

    public function setUp(): void
    {
        parent::setUp();

        // 现在可以正常执行seed了
        $this->seed(RoleAndPermissionSeeder::class);
        // 其他初始化代码
    }
}

3. 排查命令执行细节（可选） #

如果还是有问题，可以通过Artisan::output()查看命令执行日志，定位具体错误：

$exitCode = Artisan::call('migrate:fresh', [
    '--database' => 'testing',
    '--force' => true,
]);
// 打印命令输出，排查问题
dd(Artisan::output());

4. 确认.env.testing配置正确性 #

检查.env.testing中的数据库配置是否指向正确的测试数据库cinema_test，且数据库已创建、账号权限足够：

DB_TEST_HOST=127.0.0.1
DB_TEST_PORT=3306
DB_TEST_DATABASE=cinema_test
DB_TEST_USERNAME=root
DB_TEST_PASSWORD=your_password

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