Laravel执行php artisan migrate时重复执行已完成迁移的问题排查

这种情况我之前帮好几个开发者排查过，核心问题都是Laravel无法正确匹配数据库migrations表的记录和本地迁移文件的状态，导致它误以为所有迁移都没执行过。咱们一步步来排查：

• 迁移文件的Timestamp与数据库记录不匹配
  Laravel判断迁移是否执行过的核心依据是迁移文件名开头的时间戳（比如2024_05_20_123456_create_abc_table.php），它会和migrations表中migration字段的内容做精确匹配。如果备份数据库时的迁移文件和当前代码里的文件Timestamp不一致（比如复制代码时替换了文件、手动修改过Timestamp），Laravel就会把这些迁移当成未执行的。

  • 排查：打开数据库的migrations表，随便挑一条记录（比如2023_01_01_000000_create_users_table），然后去本地database/migrations目录找对应的文件，核对Timestamp是否完全一致。
  • 解决：要么修改migrations表中对应记录的migration字段，和当前文件的Timestamp对齐；要么（更推荐，避免改数据库）把本地迁移文件的Timestamp改成和数据库记录一致的。操作前记得备份好文件和数据库。

• migrations表的batch字段异常
  Laravel用batch字段对迁移进行分组，正常情况下每次执行迁移都会生成递增的batch号。如果备份的migrations表中batch值混乱（比如大量记录是0、或者batch号重复），可能会让Laravel误判迁移状态。

  • 排查：查看migrations表的batch列，正常应该是连续递增的数字，如果发现异常值，那大概率是问题所在。
  • 解决：可以把所有已完成迁移的batch值统一设置为一个较高的数字（比如100），之后执行php artisan migrate时，Laravel会从高于这个batch号的新迁移开始执行（如果有新迁移的话）。

• 连接了错误的数据库
  别笑，这种低级错误真的很常见！你以为用的是备份数据库，但.env里的配置可能指向了另一个空库，导致Laravel看不到已有的migrations记录，自然从头跑。

  • 排查：打开终端执行php artisan tinker，然后输入DB::table('migrations')->count()，如果返回的数字不是400+，说明数据库连接错了。
  • 解决：检查.env文件里的DB_DATABASE、DB_HOST等配置，确保指向备份的数据库，之后执行php artisan config:clear清除配置缓存。

• 迁移文件缺失或被篡改
  如果migrations表记录对应的迁移文件在当前代码里丢了，或者文件内容被修改过（比如文件名没变，但up()方法里的表名改了），也可能触发这个问题。

  • 排查：对比migrations表的所有记录和本地database/migrations目录的文件，看有没有缺失，或者文件内容是否和备份时一致。
  • 解决：从备份的代码中恢复缺失的文件，或者修正被篡改的内容，确保和数据库记录对应。

• Laravel缓存干扰
  复制代码和备份数据库后，旧的配置缓存、迁移缓存可能导致状态不一致。

  • 解决：依次执行以下命令清除缓存：

    php artisan cache:clear
    php artisan config:clear
    php artisan route:clear
    

    之后再尝试php artisan migrate。

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