ActiveRecord中has_many关联dependent: :destroy不生效是什么原因？

问题原因排查与解决方案 #

核心原因优先级排序 #

1. 软删除/默认作用域过滤了残留关联记录（占90%以上概率）：Rails模型查询会受default_scope或软删除插件（如acts_as_paranoid）影响，过滤掉已标记删除的记录，但数据库层面的外键约束不识别应用层的软删除规则，只要记录物理存在就会触发报错。
2. 非英语命名导致外键关联表拼写错误：你使用西班牙语命名模型，vacacion的正确复数形式为vacaciones，如果Vacacion模型自定义了表名为vacaciones，但迁移中创建外键时未显式指定关联表，Rails会默认生成关联vacacions表的外键，导致约束逻辑异常。
3. 销毁回调异常：你调试时看到的日志是删除vacaciones_percibidas表而非vacation_transactions表，说明VacationTransaction的销毁回调触发了关联VacacionPercibida的销毁，本身的记录未被正常删除。
4. 事务未提交：如果操作在未提交的事务中执行，删除关联记录的变更对其他事务不可见，销毁Vacacion时依然能读到残留的关联记录。

对应解决步骤 #

步骤1：确认数据库层面是否存在残留记录

直接连接PostgreSQL执行以下SQL（不要用Rails模型查询，避免被作用域过滤）：

SELECT id, vacacion_id, vacacion_percibida_id FROM vacation_transactions WHERE vacacion_id = 348;

• 如果有返回结果，说明确实有Rails查询不到的残留记录，直接在数据库删除这些记录后重试销毁即可，后续检查VacationTransaction的default_scope和软删除配置，调整关联销毁逻辑适配软删除规则即可。
• 如果无返回结果，进入下一步。

步骤2：核实外键约束定义

执行SQL查看报错的外键具体规则：

SELECT pg_get_constraintdef(oid) FROM pg_constraint WHERE conname = 'fk_rails_ae595e109b';

正常输出应该类似：

FOREIGN KEY (vacacion_id) REFERENCES vacacions(id) ON DELETE NO ACTION

如果关联的表名和你Vacacion模型实际对应的表名不一致，说明迁移外键配置错误，新增迁移修正即可：

# 新增迁移文件
def change
  remove_foreign_key :vacation_transactions, column: :vacacion_id
  # 第二个参数替换为你Vacacion模型实际的表名
  add_foreign_key :vacation_transactions, :vacaciones, column: :vacacion_id
end

步骤3：检查回调配置

检查VacationTransaction模型是否存在before_destroy回调阻止记录销毁，或者错误配置了belongs_to :vacacion_percibida, dependent: :destroy这类关联，导致销毁事务触发了其他表的操作但本身未被删除。

步骤4：排除事务残留

重启Rails控制台重试操作，或者确认你的操作没有在手动开启的未提交事务中执行。

内容的提问来源于stack exchange，提问作者Javier Vásquez