Laravel医疗理赔系统添加新迁移遇重复执行旧迁移问题，如何解决？

问题成因 #

• Laravel靠数据库里的migrations表追踪已执行的迁移，而非仅依赖本地迁移文件。就算你删除了本地旧迁移文件，数据库内的迁移记录仍会保留，导致系统出现状态混乱：要么提示找不到旧迁移文件，要么误判迁移执行状态；如果新创建的迁移文件不小心和已存在的表重名，就会直接触发table already found错误。
• 若未回滚旧迁移就删除本地文件，migrations表与本地文件无法匹配，执行新迁移时Laravel会出现逻辑冲突，进而尝试重复执行已记录的旧迁移。

解决方案 #

1. 仅运行新迁移（保留现有数据） #

如果不想丢失已有的业务数据，只想执行新添加的patients、practices表迁移：

• 先检查新迁移的命名规范：确保create_patients_table对应的patients表尚未创建；如果是要修改现有表，需使用add_xxx_to_patients_table这类命名，不能重复用create_xxx格式。
• 恢复之前删除的旧迁移文件（因为migrations表中有它们的执行记录，缺失文件会导致Laravel报错），然后直接执行迁移命令：

  php artisan migrate
  

  Laravel会自动对比migrations表，仅执行未被记录的新迁移。
• 若只想单独执行某几个新迁移，可指定文件路径：

  php artisan migrate --path=/database/migrations/20240520123456_create_patients_table.php
  

2. 重置迁移系统（清空数据重新执行） #

如果可以接受清空数据库数据，彻底解决迁移状态不一致的问题：

• 先回滚所有已执行的迁移：

  php artisan migrate:reset
  

  该命令会回滚所有迁移并删除对应的数据表。
• 如果回滚失败（比如已删除旧迁移文件），需手动操作数据库：
  1. 清空migrations表的所有记录；
  2. 删除roles、claim_statuses、claims这几个已创建的旧表。
• 最后重新执行所有迁移（包括新添加的文件）：

  php artisan migrate
  

避坑提醒 #

• 不要随意删除已执行过的迁移文件，如需删除，先执行php artisan migrate:rollback回滚对应迁移，避免migrations表与本地文件状态不匹配。
• 迁移文件名必须唯一，严格遵循YYYY_MM_DD_HHMMSS_迁移名称.php的格式，避免重复创建同名表的迁移。

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