Rails has_many :through关联更新记录报UnknownPrimaryKey解决方法

ActiveRecord::UnknownPrimaryKey 报错的直接触发原因是multicats作为多对多关联桥接表，建表时设置了id: false，没有默认的单字段自增主键，而代码里直接调用Multicat.update时，ActiveRecord默认需要通过主键定位单条记录，无法识别无主键表的更新目标。
除此之外现有代码还有两处配置错误：

• 桥接表对应的Multicat模型未定义，也没有声明复合主键规则
• dependent: :destroy配置位置错误：放在has_many :through关联上时，删除联系人会直接级联删除关联的列表本身，而非仅删除桥接表的关联记录，会造成数据误删。

1. 修正模型关联配置 #

首先补全桥接表模型，调整级联删除规则到直接关联桥接表的关系上：

# app/models/multicat.rb
class Multicat < ApplicationRecord
  # 声明三字段复合主键，匹配桥接表结构
  self.primary_key = [:user_id, :list_id, :contact_id]
  belongs_to :user
  belongs_to :list
  belongs_to :contact
end

# app/models/contact.rb
class Contact < ApplicationRecord
  # 级联删除仅作用于桥接记录，不会删除关联的列表
  has_many :multicats, dependent: :destroy
  has_many :lists, through: :multicats
end

# app/models/list.rb
class List < ApplicationRecord
  has_many :multicats, dependent: :destroy
  has_many :contacts, through: :multicats
end

2. 通过Rails关联代理更新多对多关系 #

has_many :through场景下不需要手动操作桥接表，直接通过主模型的关联方法赋值即可，Rails会自动维护桥接表的增删改，完全规避主键相关报错。
修正后的控制器update代码：

# PATCH/PUT /contacts/1 or /contacts/1.json
def update
  respond_to do |format|
    # 读取要绑定的目标列表
    target_list = List.find(contact_params[:list])
    # 直接更新联系人基础字段+关联列表，Rails自动处理multicats表记录
    if @contact.update(
      first_name: contact_params[:first_name],
      email: contact_params[:email],
      lists: [target_list]
    )
      format.html { redirect_to contacts_url, notice: "Contact was successfully updated." }
      format.json { render :show, status: :ok, location: @contact }
    else
      format.html { render :edit, status: :unprocessable_entity }
      format.json { render json: @contact.errors, status: :unprocessable_entity }
    end
  end
end

如果业务允许一个联系人绑定多个列表，只需要将lists参数替换为对应id的列表实例数组即可，例如传入List.where(id: contact_params[:list_ids])。

特殊场景：必须手动操作桥接表的写法 #

如果确实需要跳过关联代理直接操作桥接表，不要使用依赖主键的单条update方法，改用条件匹配的批量更新或者upsert：

# 按业务条件匹配桥接记录做更新，不需要主键
Multicat.where(
  user_id: current_user.id,
  contact_id: @contact.id
).update_all(list_id: contact_params[:list])

注意：update_all不会触发ActiveRecord模型回调和校验，仅适合对性能有要求的特殊场景，常规业务优先使用关联代理方法，保证数据一致性。

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