如何解决Rails 7中因重复created_at列导致的迁移挂起错误

错误原因 #

你的迁移文件20231003192318_add_timestamps_to_articles.rb尝试向articles表添加已存在的created_at列，导致SQLite抛出重复列名的错误。

解决步骤 #

1. 确认表结构

先确认articles表是否已存在created_at列：

• 打开Rails控制台：

  rails c
  

• 在控制台执行：

  puts Article.column_names
  

  如果输出包含created_at，说明该列已存在，当前迁移操作完全多余。

2. 方案一：移除多余迁移文件

若created_at已存在：

• 删除db/migrate/20231003192318_add_timestamps_to_articles.rb文件
• 执行命令将该迁移标记为已完成，避免后续migrate重复触发：

  rails db:migrate:mark_as_completed VERSION=20231003192318
  

• 重新执行迁移：

  rails db:migrate
  

3. 方案二：修改迁移文件（保留迁移但避免重复添加）

如果确实需要通过该迁移添加时间戳（比如仅缺失其中一列），可修改迁移文件，添加if_not_exists: true参数（Rails 6及以上版本支持）：

def change
  # 同时添加created_at和updated_at
  add_timestamps :articles, if_not_exists: true

  # 仅添加created_at的写法
  # add_column :articles, :created_at, :datetime, if_not_exists: true
end

修改后重新执行rails db:migrate即可。

4. 极端情况：重置数据库（谨慎操作，会丢失数据）

若迁移状态完全混乱，且数据库无需要保留的数据，可直接重置数据库：

rails db:reset

该命令会删除现有数据库，重新创建并执行所有迁移。

内容的提问来源于stack exchange，提问作者Afaq Shahid Khan