如何为ActiveRecord eager_load添加动态JOIN条件并实现预加载？

方案一：用Arel构造带条件的Outer Join（推荐） #

直接通过Arel拼接带自定义条件的LEFT OUTER JOIN，结合includes确保预加载生效，完全兼容ActiveRecord的查询链：

# 定义动态条件（可根据业务逻辑任意传入）
dynamic_condition = MyJointable.arel_table[:status].eq('active')

# 获取Arel表对象
my_table = MyTable.arel_table
my_jointable = MyJointable.arel_table

# 构造带条件的JOIN语句
join_clause = my_table.join(my_jointable, Arel::Nodes::OuterJoin)
                      .on(
                        my_table[:id].eq(my_jointable[:my_table_id])
                        .and(dynamic_condition)
                      )
                      .join_sources

# 执行查询：includes确保预加载，joins注入自定义JOIN条件
results = MyTable.includes(:myjointable).joins(join_clause)

方案优势 #

• JOIN条件直接写在ON子句中，不会混入WHERE，符合性能优化需求
• includes让ActiveRecord自动处理关联数据的预加载，彻底避免N+1查询
• 无需手动指定select列，ActiveRecord会自动识别并映射关联表字段，不会导致模型实例化失败

方案二：临时动态定义关联（适合复杂条件场景） #

如果需要更灵活的条件组合，可以临时给模型添加带条件的关联，用完即清理：

class MyTable < ApplicationRecord
  # 原有关联保留
  has_one :myjointable

  # 动态生成带过滤条件的临时关联
  def self.with_filtered_myjointable(condition)
    has_one :filtered_myjointable, -> { where(condition) }, 
            class_name: 'MyJointable', foreign_key: :my_table_id

    # 预加载临时关联
    query = includes(:filtered_myjointable)

    # 清理临时关联，避免污染模型全局状态
    remove_association :filtered_myjointable

    query
  end
end

# 使用方式
results = MyTable.with_filtered_myjointable(status: 'active', created_at: 1.week.ago..Time.now)
# 通过临时关联访问数据
results.first.filtered_myjointable&.a_column

方案优势 #

• 完全沿用ActiveRecord的关联语法，学习成本低
• 条件可以是任意ActiveRecord支持的查询条件（哈希、字符串、Arel）
• 临时关联用完即删，不会影响模型的原有功能

避坑提醒 #

• 不要直接用eager_load搭配自定义joins：会导致ActiveRecord丢失关联表的列映射，触发N+1查询
• 禁止手动写select("mytable.*, myjointable.*")：会干扰ActiveRecord的实例化逻辑，引发路由或模型错误
• 优先用includes而非preload：includes会根据查询自动切换预加载策略，配合自定义joins更稳定

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