如何移除Rails中已不存在的旧数据库迁移文件？

问题背景 #

数据库bird_app_development中存在两条标记为up但本地迁移文件已丢失的记录，执行rails db:rollback时触发ActiveRecord::UnknownMigrationVersionError，提示找不到对应版本的迁移文件。

解决步骤 #

1. 确认无效迁移版本
   先通过Rails控制台或数据库客户端查看schema_migrations表中的无效版本记录：

   • 用Rails控制台执行：

     ActiveRecord::Base.connection.execute("SELECT version FROM schema_migrations WHERE version IN ('20231003031851', '20231006010235')")
     

   • 或直接通过数据库命令（以PostgreSQL为例）：

     -- 先进入数据库：psql bird_app_development
     SELECT version FROM schema_migrations WHERE version IN ('20231003031851', '20231006010235');
     

2. 删除无效迁移记录
   确认记录存在后，执行删除操作：

   • Rails控制台方式：

     ActiveRecord::Base.connection.execute("DELETE FROM schema_migrations WHERE version IN ('20231003031851', '20231006010235')")
     

   • 数据库命令方式：

     DELETE FROM schema_migrations WHERE version IN ('20231003031851', '20231006010235');
     

3. 验证清理结果
   执行迁移状态查询命令确认无效记录已移除：

   rails db:migrate:status
   

   此时再执行rails db:rollback即可正常运行。

注意事项 #

• 操作前务必备份数据库，避免因误操作导致数据丢失。
• 确认丢失的迁移文件对应的数据库结构变更已被保留在当前数据库中（可通过对比schema.rb文件验证），若存在结构缺失，需先恢复结构再清理迁移记录。

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