Rails同模型has_many关联实现产品捆绑时RecordNotFound问题排查

问题背景 #

已为Product模型的enum添加bundle类型，通过BundleProduct中间表实现捆绑产品包含其他产品的关联。控制台操作中间表记录正常，但表单提交参数时出现RecordNotFound异常：

ActiveRecord::RecordNotFound: Couldn't find all BundleProducts with 'id': (309, 12, 225)
(found 0 results, but was looking for 3). Couldn't find BundleProducts with ids 309, 12, 225.

提交参数为：

{"product"=>{"bundle_product_ids"=>["309", "12", "225"]}}

日志显示Rails错误地根据ID查询BundleProduct表，而非通过product_id关联目标Product。

问题原因 #

当前Product模型仅定义了与BundleProduct中间表的直接关联：

has_many :bundle_products, :foreign_key => :bundle_id, :dependent => :destroy

当提交bundle_product_ids参数时，Rails会默认将其视为BundleProduct模型的ID集合，而非要关联的ProductID。但表单传入的309、12、225是目标产品的ID，并非中间表记录的ID，因此触发查找失败。

解决方案 #

1. 完善模型关联 #

在Product模型中添加通过中间表关联被包含产品的has_many :through关联，明确关联指向：

class Product < ApplicationRecord
  enum :product_type => { :book => 1, :supplies => 2, :bundle => 3 } 
  has_many :bundle_products, :foreign_key => :bundle_id, :dependent => :destroy
  # 添加该关联，通过bundle_products中间表关联到被包含的Product
  has_many :included_products, through: :bundle_products, source: :product
end

2. 调整参数处理 #

方式一：修改表单参数名

将表单中提交的参数键从bundle_product_ids改为included_product_ids，这样Rails会自动识别为关联included_products的ID集合，自动创建/更新BundleProduct中间表记录。

控制器参数许可代码调整为：

def product_params
  params.require(:product).permit(:product_type, included_product_ids: [])
end

方式二：兼容原有参数名（无需修改表单）

如果不想改动表单，可在控制器参数处理中映射参数：

def product_params
  permitted = params.require(:product).permit(:product_type, bundle_product_ids: [])
  # 将bundle_product_ids映射为included_product_ids
  permitted[:included_product_ids] = permitted.delete(:bundle_product_ids)
  permitted
end

验证效果 #

修改完成后，执行product.update!(product_params)时，Rails会自动创建bundle_products记录，设置bundle_id为当前捆绑产品ID，product_id为提交的目标产品ID，无需手动操作中间表。

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