Rails同表双向has_many关联异常：添加关联数据未保存

问题描述 #

需要让每个User模型拥有两个指向Caregivers表的引用，实现双向has_many关联，但执行current_user.reported_caregivers << @caregiver并调用current_user.save后，关联数据并未被保存。

现有代码 #

模型代码 #

class Caregiver < ApplicationRecord
  has_many :users, dependent: :nullify # 第一个与User的关联
  has_many :reporters, :class_name => 'User', dependent: :nullify # 新增的关联
end

class User < ApplicationRecord
  has_many :caregivers, dependent: :nullify # 第一个与Caregiver的关联
  has_many :reported_caregivers, :class_name => 'Caregiver', dependent: :nullify # 新增的关联
  # ... 其他代码
end

迁移代码 #

class AddReportersToCaregivers < ActiveRecord::Migration[7.0]
  def change
    add_reference :caregivers, :reporters, foreign_key: { to_table: :users}, default: []
  end
end

class AddReportedCaregiversToUsers < ActiveRecord::Migration[7.0]
  def change
    add_reference :users, :reported_caregivers, foreign_key: { to_table: :caregivers}, default: []
  end
end

问题原因 #

你的配置存在核心错误：

1. 迁移逻辑错误：直接在主表添加外键是一对多关联的配置方式，无法实现多对多（一个用户可举报多个护工、一个护工可被多个用户举报），多对多必须通过中间连接表实现。
2. 模型关联错误：没有指定多对多关联所需的连接表和对应外键，Rails无法识别关联关系，导致添加操作无效。

解决方案 #

步骤1：回滚错误迁移 #

执行命令回滚之前的两个迁移：

rails db:rollback STEP=2

步骤2：创建多对多连接表迁移 #

生成用于存储用户举报护工关联记录的连接表：

# 执行生成命令：rails generate migration CreateCaregiverReports user:references caregiver:references
class CreateCaregiverReports < ActiveRecord::Migration[7.0]
  def change
    create_table :caregiver_reports do |t|
      t.references :user, null: false, foreign_key: true
      t.references :caregiver, null: false, foreign_key: true

      t.timestamps
    end
    # 可选：添加唯一约束，避免同一用户重复举报同一护工
    add_index :caregiver_reports, [:user_id, :caregiver_id], unique: true
  end
end

运行迁移：

rails db:migrate

步骤3：修正模型关联配置 #

User模型

class User < ApplicationRecord
  # 原有关联（假设为一对多：用户拥有多个护工，caregivers表含user_id外键）
  has_many :caregivers, dependent: :nullify

  # 新增关联：用户举报的护工（多对多）
  has_many :caregiver_reports, dependent: :destroy
  has_many :reported_caregivers, through: :caregiver_reports, source: :caregiver
end

Caregiver模型

class Caregiver < ApplicationRecord
  # 原有关联（假设为一对多：护工被多个用户拥有，users表含caregiver_id外键）
  has_many :users, dependent: :nullify

  # 新增关联：举报该护工的用户（多对多）
  has_many :caregiver_reports, dependent: :destroy
  has_many :reporters, through: :caregiver_reports, source: :user
end

步骤4：测试关联操作 #

现在控制器中执行以下代码即可正常保存关联：

current_user.reported_caregivers << @caregiver
# <<操作会自动保存关联，无需手动调用current_user.save
# 验证关联是否生效：
current_user.reported_caregivers.include?(@caregiver) # 返回true即为成功

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