Laravel迁移失败时如何实现全量事务回滚？

需求：当数据库迁移失败时回滚所有变更——即便有30个待执行迁移，只要其中一个执行失败，所有迁移都不生效。

尝试第一种实现方式：

\DB::connection($this->getConnectionName($databaseName))->beginTransaction();
$migrator = app(Migrator::class);
$migrator->setConnection($this->getConnectionName($databaseName));

try {
    $migrator->run('database/workspace/migrations', [
        '--force' => env('APP_ENV') === 'production',
    ]);

    \DB::connection($this->getConnectionName($databaseName))->commit();
} catch (\Exception $exception) {
    \DB::connection($this->getConnectionName($databaseName))->rollBack();
    throw $exception;
}

执行时提示「没有任何活跃事务」。

又尝试第二种实现方式：

$migrator = app(Migrator::class);
$migrator->setConnection($this->getConnectionName($databaseName));

try {
    $migrationsPath = 'database/workspace/migrations';
    $files = $migrator->getMigrationFiles($migrationsPath);

    $migrations = $migrator->pendingMigrations($files, $migrator->getRepository()->getRan());

    $batch = $migrator->getRepository()->getNextBatchNumber();

    foreach ($migrations as $migration) {
        $migrator->runUp($migration, $batch, 0);
    }

    \DB::connection($this->getConnectionName($databaseName))->commit();
} catch (\Exception $exception) {
    \DB::connection($this->getConnectionName($databaseName))->rollBack();
    throw $exception;
}

结果迁移既没有被提交，也没有被回滚。

请问如何将迁移命令纳入全局事务处理？

要实现所有迁移在单个事务中执行、失败全回滚，核心是禁用Laravel迁移默认的单迁移事务机制，同时手动控制全局事务的开启、提交与回滚，具体实现如下：

$connectionName = $this->getConnectionName($databaseName);
$connection = \DB::connection($connectionName);

// 开启全局事务
$connection->beginTransaction();

$migrator = app(Migrator::class);
$migrator->setConnection($connectionName);

try {
    $migrationsPath = 'database/workspace/migrations';
    $files = $migrator->getMigrationFiles($migrationsPath);
    $pendingMigrations = $migrator->pendingMigrations($files, $migrator->getRepository()->getRan());
    $batch = $migrator->getRepository()->getNextBatchNumber();

    foreach ($pendingMigrations as $migration) {
        // 实例化迁移类，跳过默认事务包装
        $migrationInstance = $migrator->resolve($migration);
        // 直接执行up方法，避免触发Migrator内置的事务逻辑
        $migrationInstance->up();
        // 手动记录迁移执行状态，更新migrations表
        $migrator->getRepository()->log($migration, $batch);
    }

    // 所有迁移执行成功，提交全局事务
    $connection->commit();
} catch (\Exception $exception) {
    // 任意迁移失败，回滚全局事务
    $connection->rollBack();
    throw $exception;
}

关键说明： #

• 不使用$migrator->run()或$migrator->runUp()，因为这两个方法内部会自动为单个迁移开启独立事务，导致全局事务被嵌套覆盖，引发「无活跃事务」错误
• 手动实例化迁移类并调用up()，跳过Laravel默认的事务包装逻辑
• 执行完成后必须手动调用log()更新migrations表，确保迁移记录与实际执行状态一致
• 注意：此方案仅适用于支持DDL事务的数据库（如PostgreSQL），MySQL默认不支持CREATE TABLE/ALTER TABLE等DDL语句的事务回滚，即使开启全局事务也无法回滚此类操作

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