保障 Laravel 迁移原子性的方法包括：一、用 DB::transaction 包裹迁移逻辑；二、手动控制事务生命周期；三、拆分高风险迁移为独立事务步骤；四、用 migrate:fresh --seed 替代增量迁移；五、嵌入行级锁防并发冲突。
如果您在执行数据库迁移时遇到部分操作成功、部分失败导致数据库结构不一致的问题，则很可能是迁移过程未被事务包裹。以下是保障 Laravel 迁移原子性的多种方法：
一、使用 DB::transaction 包裹迁移逻辑
该方法将整个 up() 或 down() 方法中的数据库变更操作纳入单个事务，确保所有 DDL/DML 操作要么全部生效，要么全部撤销。Laravel 默认不为迁移启用事务，需手动添加。
1、在迁移文件的 up() 方法顶部调用 DB::transaction()，并将原有逻辑放入闭包中。
2、在闭包内执行 Schema::create()、Schema::table()、DB::table()->insert() 等操作。
3、若任意操作触发异常（如字段重复、外键冲突、权限不足），事务自动回滚，数据库状态恢复至迁移前。
4、注意：MySQL 8.0+ 和 PostgreSQL 支持 DDL 事务，但 MySQL 5.7 及更早版本对某些 DDL 语句（如 ALTER TABLE）会隐式提交，此时事务无法回滚该 DDL 操作。
二、在迁移中手动控制事务生命周期
当需要根据条件决定是否提交、或需在事务中执行复杂判断与日志记录时，应采用显式 beginTransaction/commit/rollback 流程，并严格校验事务层级。
1、在 up() 方法起始处调用 DB::beginTransaction()。
2、在 try 块中依次执行表创建、列添加、默认值插入等操作。
3、所有操作完成后调用 DB::commit()。
4、在 catch 块中检查 DB::transactionLevel() > 0 后执行 DB::rollback()，避免在无活跃事务时调用 rollback 导致 PDO 异常。
5、重新抛出捕获的异常，确保 Artisan 命令终止并标记迁移失败。
三、拆分高风险迁移为独立事务步骤
针对包含多个 DDL 操作（如重命名表 + 添加索引 + 更新数据）的迁移，应将其分解为多个独立迁移文件，每个文件仅含一个事务性变更，降低单次失败影响范围。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
1、将原迁移拆分为 create_new_table.php、add_index_to_users.php、migrate_legacy_data.php 三个文件。
2、每个文件的 up() 方法均使用 DB::transaction() 包裹其唯一核心操作。
3、为每个迁移添加幂等性检查，例如在 create_new_table.php 中先判断表是否存在再执行 Schema::create()。
4、在 down() 方法中同样使用事务包裹反向操作，确保 rollback 行为与 up() 具有对称性。
四、利用 migrate:fresh --seed 替代高风险增量迁移
在开发与测试环境，当迁移逻辑过于复杂或已出现不一致状态时，可放弃增量修复，改用清空重建策略，由事务保障整个初始化流程的原子性。
1、运行 php artisan migrate:fresh 命令，该命令内部自动使用 DB::transaction 执行所有 down() 再 up()。
2、配合 --seed 参数一次性加载基础数据，种子文件中的 DB::table()->insert() 操作也被包含在该事务中。
3、此方式仅适用于无生产数据或允许全量重建的环境，严禁在生产数据库直接使用。
五、在迁移中嵌入行级锁防止并发冲突
当迁移涉及数据迁移（如从旧字段计算新字段值）且可能被其他进程并发访问时，需在事务内对目标记录加锁，避免脏读或覆盖写入。
1、在 DB::transaction 闭包中，使用 DB::table('users')->where('status', 'pending')->lockForUpdate()->get() 获取待处理记录集。
2、遍历结果集并执行更新操作，所有更新均处于同一事务上下文。
3、若其他迁移或应用请求同时尝试锁定相同行，将被阻塞直至当前事务结束。
4、lockForUpdate 仅在事务内有效，且要求数据库引擎支持（InnoDB/PostgreSQL）。
