如何为STI子类预加载has_one关联，规避N+1查询问题？

这个问题在Rails的单表继承（STI）场景里很常见——因为每个子类只定义了自己的关联，直接在父类集合上include所有子类关联会触发关联不存在的错误，Rails会检查每个实例的类是否拥有指定的关联。下面给你几种符合Rails惯用风格的解决方案：

方案1：分类型批量预加载（无需修改现有结构） #

这是最直接且不改动现有代码的方式，利用Rails的预加载机制针对不同子类分别处理：

# 先获取所有活动记录
activities = Activity.all.to_a

# 筛选出HelloActivity实例，批量预加载它的详情
HelloActivity.preload(:hello_activity_details).call_on(activities.select { |a| a.is_a?(HelloActivity) })

# 同样处理WorldActivity的详情
WorldActivity.preload(:world_activity_details).call_on(activities.select { |a| a.is_a?(WorldActivity) })

或者用ActiveRecord::Associations::Preloader来更简洁地实现：

activities = Activity.all
preloader = ActiveRecord::Associations::Preloader.new

# 预加载HelloActivity的详情
preloader.preload(activities.grep(HelloActivity), :hello_activity_details)
# 预加载WorldActivity的详情
preloader.preload(activities.grep(WorldActivity), :world_activity_details)

这两种方式都只会触发3次查询（一次查所有Activity，一次查所有HelloActivityDetail，一次查所有WorldActivityDetail），完美避免N+1，而且不会触发关联不存在的错误。

方案2：重构为多态关联（长期优雅方案） #

如果你的项目允许调整数据库结构，把详情表改成多态关联是更优雅的长期解决方案，这样可以统一父类的关联逻辑：

第一步：生成迁移修改详情表 #

class AddPolymorphicToActivityDetails < ActiveRecord::Migration[7.0]
  def change
    # 给两个详情表添加多态关联字段
    add_reference :hello_activity_details, :activity, polymorphic: true, index: true
    add_reference :world_activity_details, :activity, polymorphic: true, index: true

    # 移除原来的子类外键（比如hello_activity_id）
    remove_reference :hello_activity_details, :hello_activity, index: true
    remove_reference :world_activity_details, :world_activity, index: true
  end
end

第二步：修改模型定义 #

class Activity < ApplicationRecord
  # 统一的详情访问方法，子类会各自实现具体关联
  def details
    activity_detail
  end
end

class HelloActivity < Activity
  has_one :activity_detail, as: :activity, class_name: 'HelloActivityDetail', dependent: :destroy
end

class WorldActivity < Activity
  has_one :activity_detail, as: :activity, class_name: 'WorldActivityDetail', dependent: :destroy
end

class HelloActivityDetail < ApplicationRecord
  belongs_to :activity, polymorphic: true
end

class WorldActivityDetail < ApplicationRecord
  belongs_to :activity, polymorphic: true
end

第三步：统一预加载 #

现在你可以用更简洁的方式预加载所有详情：

activities = Activity.all.includes(
  hello_activity: :activity_detail,
  world_activity: :activity_detail
)

# 访问详情时统一调用details方法
activities.each do |activity|
  puts activity.details.inspect
end

方案3：避免关联检查的小技巧（不推荐） #

如果你不想改动模型也不想手动预加载，可以尝试用left_joins配合includes绕过关联检查，但这种方式不够直观，且可能在后续Rails版本中出现兼容性问题：

activities = Activity.all.left_joins(:hello_activity_details, :world_activity_details).includes(
  :hello_activity_details,
  :world_activity_details
)

总的来说，方案1是最适合你当前场景的惯用解决方案，无需改动现有结构就能解决N+1问题；如果项目有长期维护需求，方案2的多态重构会让代码更整洁。

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