Rails合并多份用户表迁移文件且不丢失数据的方法

核心原则 #

永远不要修改已经在任何环境执行过的迁移文件——Rails依赖schema_migrations表记录已执行的迁移版本，修改旧迁移会导致不同环境的数据库结构不一致，引发团队协作或部署问题。

问题根源 #

你直接替换旧的CreateUsers迁移并运行时出错，原因有三个：

1. 数据库中已存在users表，create_table会抛出「表已存在」的错误
2. 旧的CreateUsers迁移已被记录在schema_migrations中，Rails不会重复执行它
3. 你期望的迁移文件里is_landlord字段前有多余空格，属于语法错误

解决方案 #

步骤1：同步最新数据库结构

先确保本地db/schema.rb是最新状态，执行：

rails db:migrate

步骤2：调整字段名（匹配你的期望结构）

生成新迁移来重命名字段：

rails generate migration RenameUserRoleColumns

编辑生成的迁移文件：

class RenameUserRoleColumns < ActiveRecord::Migration[7.0]
  def change
    rename_column :users, :student, :is_student
    rename_column :users, :landlord, :is_landlord
  end
end

运行迁移生效：

rails db:migrate

步骤3：合并迁移文件（仅适用于开发环境）

如果只是想让代码更整洁，仅在开发环境操作（需同步团队成员）：

1. 备份当前数据库数据（比如用pg_dump或MySQL导出工具），同时备份db/schema.rb
2. 删除旧的三个迁移文件：create_users.rb、add_email_to_users.rb、add_student_to_users.rb
3. 创建合并后的新迁移文件（修正语法错误）：

class CreateUsers < ActiveRecord::Migration[7.0]
  def change
    create_table :users do |t|
      t.string :username
      t.string :email
      t.string :password_digest
      t.boolean :is_student
      t.boolean :is_landlord
      t.timestamps
    end
  end
end

4. 清空迁移版本记录（仅开发环境）：

rails db:execute "DELETE FROM schema_migrations;"

5. 运行新迁移并恢复备份数据：

rails db:migrate
# 导入之前备份的数据

生产/团队协作环境的正确做法

在生产环境或多开发者团队中，绝对不能删除旧迁移：

• 保留所有已执行的迁移文件
• 通过步骤2的新迁移调整字段名
• 新环境初始化时，用db:schema:load直接加载最新结构（相当于合并所有迁移的效果），而非逐个运行迁移：

rails db:schema:load

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