Ruby on Rails执行db:schema:load时因外键约束报错求助

我在使用Ruby 2.7、Ruby on Rails 5.2.8.1的项目中，于新系统上采用MySQL 5.7数据库搭建环境，每次执行bundle exec rake db:create db:schema:load都会因外键错误失败。奇怪的是，schema.rb中add_foreign_key语句位于最后，但执行时错误信息显示删除categories表时因外键约束失败，无法理解此行为。

简化后的schema.rb

ActiveRecord::Schema.define(version: 20211230212616) do

  create_table "categories", force: :cascade, options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci" do |t|
    t.integer "category_id", null: false
    t.string "subtitle"
    t.text "page_content"
    t.text "pinned_styles"
    t.text "unpinned_styles"
    t.text "updated_by"
    t.datetime "created_at", null: false
    t.datetime "updated_at", null: false
    t.index ["category_id"], name: "index_categories_on_category_id", unique: true
  end

  create_table "faqs", force: :cascade, options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci" do |t|
    t.text "question"
    t.text "answer"
    t.bigint "category_id"
    t.datetime "created_at", null: false
    t.datetime "updated_at", null: false
    t.index ["category_id"], name: "index_faqs_on_category_id"
  end

  add_foreign_key "faqs", "categories"
end

错误信息

bundle exec db:drop db:create db:schema:load

-- create_table("categories", {:force=>:cascade, :options=>"ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci"})
rake aborted!
ActiveRecord::StatementInvalid: Mysql2::Error: Cannot delete or update a parent row: a foreign key constraint fails: DROP TABLE IF EXISTS `categories` CASCADE
/Users/olivar/RubymineProjects/catalog/db/schema.rb:15:in `block in <main>'
/Users/olivar/RubymineProjects/catalog/db/schema.rb:13:in `<main>'
/Users/olivar/.rbenv/versions/2.7.2/bin/bundle:25:in `load'
/Users/olivar/.rbenv/versions/2.7.2/bin/bundle:25:in `<main>'

Caused by:
Mysql2::Error: Cannot delete or update a parent row: a foreign key constraint fails
/Users/olivar/RubymineProjects/catalog/db/schema.rb:15:in `block in <main>'
/Users/olivar/RubymineProjects/catalog/db/schema.rb:13:in `<main>'
/Users/olivar/.rbenv/versions/2.7.2/bin/bundle:25:in `load'
/Users/olivar/.rbenv/versions/2.7.2/bin/bundle:25:in `<main>'
Tasks: TOP => db:schema:load

原因分析与解决方案 #

核心原因 #

问题出在create_table的force: :cascade参数上：

• 当指定force: :cascade时，Rails执行create_table前会先尝试删除已存在的同名表。
• 如果数据库中已经存在faqs表，且之前已经建立了它与categories的外键约束，那么删除categories表时会被MySQL的外键规则阻止，因为faqs依赖于categories。
• 哪怕schema.rb里的add_foreign_key在最后，只要数据库中已经存在外键约束，执行create_table categories的删除步骤就会触发冲突。

解决方法 #

1. 彻底清空后重新执行
   严格按顺序执行：

   bundle exec rake db:drop db:create db:schema:load
   

   确保db:drop完全清空数据库，避免残留的表和外键约束干扰后续步骤。

2. 临时禁用外键检查
   在schema.rb开头和结尾添加外键检查开关：

   ActiveRecord::Schema.define(version: 20211230212616) do
     execute "SET FOREIGN_KEY_CHECKS = 0;" # 开头禁用
   
     # 原有的create_table和add_foreign_key代码...
   
     execute "SET FOREIGN_KEY_CHECKS = 1;" # 结尾恢复
   end
   

   这样执行schema:load时会暂时关闭外键约束，避免表删除/创建时的冲突。

3. 移除force: :cascade参数
   如果是全新环境搭建，不需要强制删除旧表，可以去掉create_table中的force: :cascade，只在表不存在时创建，避免触发删除操作。

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