Rails中accepts_nested_attributes_for无法关联传入记录的问题

我们的Attachment模型用于关联团队logo，因为采用客户端S3上传方案，需要先生成S3密钥并确认，所以Attachment会先保存到数据库，之后再关联至Team。

现有代码实现 #

Team模型 #

class Team < ApplicationRecord
  has_many :logos, as: :attachable, class_name: "Attachment", dependent: :destroy, after_add: :cache_logo_url, inverse_of: :attachable
  accepts_nested_attributes_for :logos, allow_destroy: true
end

Attachment模型 #

class Attachment < ApplicationRecord
  belongs_to :attachable, polymorphic: true, optional: true
end

Teams控制器 #

class Api::V1::TeamsController < Api::V1::BaseController
  def update
    @team = Team.find(params[:id])
    authorize @team

    if @team.update(params)
      render status: :no_content
    else
      validation_error(@team.errors)
    end
  end

  private
  def team_params
    params.require(:team).permit(
      :name, 
      logos_attributes: [:id, :_destroy]
    )
  end
end

问题现象 #

发送PUT请求更新Team时，出现错误：Rails无法找到id为1021的Attachment，原因是该记录的attachable未设置。需求是让Rails仅通过ID找到Attachment，然后将其关联到Team。

问题出在accepts_nested_attributes_for的默认行为：默认情况下它会尝试更新传入ID的关联记录，而非直接关联已存在的记录。要实现仅通过ID关联已存在Attachment，需做以下调整：

1. 添加update_only: true配置
   修改Team模型中的accepts_nested_attributes_for，告诉Rails当传入已存在记录的ID时，仅处理关联逻辑而非修改记录本身：

   class Team < ApplicationRecord
     has_many :logos, as: :attachable, class_name: "Attachment", dependent: :destroy, after_add: :cache_logo_url, inverse_of: :attachable
     accepts_nested_attributes_for :logos, allow_destroy: true, update_only: true
   end
   

2. 确认参数格式
   发送PUT请求时，参数需包含logos_attributes数组并传入Attachment的ID：

   {
     "team": {
       "logos_attributes": [
         { "id": 1021 }
       ]
     }
   }
   

   此时Rails会自动找到对应ID的Attachment，将其attachable关联到当前Team。

3. 替代方案：直接操作关联集合
   如果不需要嵌套属性的其他功能，也可以跳过accepts_nested_attributes_for，直接在控制器中操作关联集合：

   # 在TeamsController的update方法中
   def update
     @team = Team.find(params[:id])
     authorize @team
   
     # 关联已存在的Attachment
     if params.dig(:team, :logo_ids).present?
       @team.logos << Attachment.find(params.dig(:team, :logo_ids))
     end
   
     if @team.update(team_params)
       render status: :no_content
     else
       validation_error(@team.errors)
     end
   end
   
   private
   def team_params
     params.require(:team).permit(
       :name, 
       logo_ids: []
     )
   end
   

   这种方式更直接，适合仅关联已存在记录的场景。

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