Rails7中如何结合自定义Preloader与includes实现关联预加载？

问题原因 #

你遇到的核心问题是：includes(:taxons)会返回一个新的ActiveRecord::Relation对象，当调用first或to_a时，Rails会重新执行查询并生成全新的Product实例，而非复用之前通过Preloader预加载的实例，因此原有实例上的vendor关联缓存会丢失。直接传入预加载器实例到includes是错误用法，因为includes仅接受关联名称或关联配置哈希。

解决方案 #

方案1：用Preloader一次性预加载所有关联（推荐）

直接通过ActiveRecord::Associations::Preloader同时处理带自定义scope的vendor和普通的taxons关联，无需依赖includes：

# 先获取主记录数组
records = Product.where(id: [1,2,3,4]).to_a

# 定义多关联预加载配置：vendor带自定义scope，taxons正常预加载
preload_configs = [
  { name: :vendor, scope: Vendor.where.not(id: [5,6]) },
  :taxons
]

# 执行批量预加载
ActiveRecord::Associations::Preloader.new(records:, associations: preload_configs).call

# 验证缓存状态
puts records.first.association_cached?(:vendor) # => true
puts records.first.association_cached?(:taxons) # => true

方案2：先通过includes加载普通关联，再用Preloader处理自定义scope关联

如果习惯用includes处理部分关联，可以先加载taxons得到实例数组，再对该数组执行自定义vendor预加载：

# 先通过includes加载taxons，得到实例数组
records = Product.where(id: [1,2,3,4]).includes(:taxons).to_a

# 对已有的实例数组执行自定义vendor预加载
scope = Vendor.where.not(id: [5,6])
ActiveRecord::Associations::Preloader.new(records:, associations: :vendor, scope:).call

# 验证缓存状态
puts records.first.association_cached?(:vendor) # => true
puts records.first.association_cached?(:taxons) # => true

关键注意点 #

• 避免先预加载再调用includes：includes返回的Relation对象执行查询后会生成新实例，原有实例的缓存无法复用
• Preloader支持接收数组形式的关联配置，可以混合普通关联和带自定义scope的关联配置

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