Rails使用嵌套属性向现有父记录添加子记录触发唯一约束问题

现象说明 #

你遇到的报错属于Rails ActiveRecord的预期设计：create方法的默认行为就是直接生成新的父记录插入数据库，不会主动校验是否已存在同唯一键的记录，因此当重复提交相同email字段的内容时，就会触发数据库唯一约束报错。

解决方法 #

不需要修改关联校验逻辑，仅需调整EmailsController的create动作逻辑，优先查找已存在的父记录，再执行属性赋值和保存即可：

class EmailsController < ApplicationController
  def create
    # 优先用唯一键email查找已有记录，不存在则初始化新记录
    @email = Email.find_or_initialize_by(email: email_params[:email]&.downcase)
    # 赋值所有参数，包含嵌套的子记录属性
    @email.assign_attributes(email_params)
    # 保存：已存在的父记录会直接新增子记录，不存在的父记录会同时创建父子记录
    @email.save
  end

  def email_params
    params.require(:email).permit(:name, :email, :phone, 
      contact_emails_attributes: %i[content subject],
      credit_emails_attributes: %i[amount pay_time], 
      card_emails_attributes: %i[content])
  end
end

可选优化：不修改已存在父记录的基础信息 #

如果业务要求不能更新已有的Email记录的name、phone字段，仅允许新增子记录，可以调整赋值逻辑：

def create
  @email = Email.find_or_initialize_by(email: email_params[:email]&.downcase)
  if @email.new_record?
    # 新记录赋值所有字段
    @email.assign_attributes(email_params)
  else
    # 已有记录仅赋值嵌套子记录属性，不修改父记录基础信息
    @email.assign_attributes(email_params.except(:name, :phone))
  end
  @email.save
end

原理说明 #

调整后逻辑会先命中数据库的唯一索引查询，复用已有的父记录，此时嵌套属性的写入逻辑会自动关联到已有父记录上，仅生成子记录的INSERT语句，不会再尝试创建新的父记录，因此不会触发唯一约束报错。

内容的提问来源于stack exchange，提问作者Juan David Martinez Cubillos