为何add_foreign_key的on_delete: :cascade未同步到schema.rb？

看起来你大概率是混淆了Rails模型关联逻辑和数据库级外键约束的配置方式，或是没通过正确的迁移流程修改外键规则，才导致db:reset后配置丢失。我来拆解原因和落地解决办法：

核心原因分析 #

1. 配置位置错误：你提到的add_foreign_key ... on_delete: :cascade是数据库级外键的配置，必须写在迁移文件里，而非直接修改模型或手动编辑schema.rb。schema.rb是Rails自动生成的数据库结构快照，手动修改它不会持久化——db:reset会重新加载迁移执行后的schema状态，要是你没在迁移里定义这个规则，重置后自然会丢失。
2. 混淆应用层与数据库层逻辑：模型里的dependent: :destroy/:delete_all是Rails应用层面的关联销毁逻辑，而on_delete: :cascade是数据库层面的约束。如果直接在数据库中删除父记录（比如用psql命令行操作），应用层逻辑不会触发，这时候必须依赖数据库级的外键约束来避免报错。

分步解决办法 #

1. 生成迁移文件修改外键约束 #

先创建一个迁移来更新你的外键规则，以图片表关联到父表（比如posts）为例：

rails generate migration AddOnDeleteCascadeToImagesParentForeignKey

打开生成的迁移文件，替换内容为：

class AddOnDeleteCascadeToImagesParentForeignKey < ActiveRecord::Migration[7.0] # 注意替换成你的Rails版本
  def change
    # 先移除已存在的旧外键（如果之前已有外键约束）
    remove_foreign_key :images, :posts # 替换成你的子表和父表名
    # 重新添加带on_delete: :cascade的外键
    add_foreign_key :images, :posts, on_delete: :cascade
  end
end

2. 执行迁移更新schema.rb #

运行迁移让数据库和schema.rb同步：

rails db:migrate

此时打开schema.rb，你应该能看到类似这样的条目：

add_foreign_key "images", "posts", on_delete: :cascade

3. 重置数据库验证效果 #

现在执行db:reset：

rails db:reset

重置后的数据库会继承schema.rb里的外键约束，此时无论是通过Rails删除父记录，还是直接在数据库中操作，都不会再触发ForeignKeyViolation错误了。

额外提示 #

• 如果你的需求是在Rails应用层面处理关联销毁，可以在模型中添加dependent: :destroy（会触发子记录的回调）或者dependent: :delete_all（直接批量删除，不触发回调），比如：

  class Post < ApplicationRecord
    has_many :images, dependent: :destroy
  end
  

  但这种方式只覆盖应用层操作，数据库直接操作仍需要依赖on_delete: :cascade。
• 永远不要手动编辑schema.rb，所有数据库结构变更都应该通过迁移文件来完成，这是Rails的最佳实践。

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