Rails迁移：如何禁用外键检查将所有主键改为UUID格式？

问题原因 #

你遇到的错误本质是：即便临时关闭外键检查，直接修改主键列类型的操作在MariaDB中仍会被阻止——数据库能识别到该列被外键约束引用，因此拒绝执行修改。正确流程需要先移除关联外键、同步修改关联列类型，最后重建约束。

正确迁移步骤 #

以cities表为例（假设关联表为some_other_table，外键列是city_id），完整迁移代码如下：

class ConvertCitiesIdToUuid < ActiveRecord::Migration[7.0]
  def up
    # 关闭外键检查
    execute "SET FOREIGN_KEY_CHECKS=0;"

    # 删除关联表的外键约束
    remove_foreign_key :some_other_table, :cities

    # 修改cities表主键为UUID，设置默认值自动生成
    change_column :cities, :id, :uuid, default: "uuid()", null: false

    # 同步修改关联表的外键列类型为UUID
    change_column :some_other_table, :city_id, :uuid, null: false

    # 重新建立外键约束
    add_foreign_key :some_other_table, :cities

    # 恢复外键检查
    execute "SET FOREIGN_KEY_CHECKS=1;"
  end

  def down
    # 回滚操作（按需调整）
    execute "SET FOREIGN_KEY_CHECKS=0;"
    remove_foreign_key :some_other_table, :cities
    change_column :some_other_table, :city_id, :bigint, null: false
    change_column :cities, :id, :bigint, auto_increment: true, null: false
    add_foreign_key :some_other_table, :cities
    execute "SET FOREIGN_KEY_CHECKS=1;"
  end
end

关键注意事项 #

• 必须先删外键：直接修改主键列时，数据库会识别到外键引用关系，即便关闭检查也会阻止操作，因此必须先移除关联外键。
• UUID默认值配置：添加default: "uuid()"确保新插入的记录自动生成UUID，适配MariaDB的UUID生成逻辑。
• 关联列同步修改：关联表的外键列类型必须与主键列保持一致，否则重建外键时会触发类型不匹配错误。
• 用up/down替代change：修改列类型的操作无法自动回滚，显式定义up和down方法更可靠。

批量处理多张表的建议 #

如果要修改所有表的主键为UUID，可通过遍历数据库表列表自动化操作，但需注意：

• 跳过Rails内置表（如schema_migrations、ar_internal_metadata）
• 操作前务必备份数据库，避免数据丢失
• 逐一处理关联关系，确保所有外键列同步完成类型修改

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