Rails Active Record多父关联查询：merge与or合并兼容性报错问题

问题背景 #

现有模型定义：

class Child < ApplicationRecord
    belongs_to :parent1, class_name: "Parent"
    belongs_to :parent2, class_name: "Parent"
end

class Parent < ApplicationRecord
    has_many :children
end

需求是复用父模型的查询逻辑（如ParentActiveRecordRelation），通过.merge()或.or()链式调用关联查询以减少SQL次数，同时支持两种场景：

1. 同一父条件需匹配parent1或parent2
2. 不同父条件分别匹配parent1和parent2

尝试以下代码时触发结构不兼容错误：

Child.where(**child_criteria).joins(:parent1).merge(Parent1ActiveRecordRelation).or(Child.where(**child_criteria).joins(:parent2).merge(Parent2ActiveRecordRelation))

错误信息：

ArgumentError: Relation passed to #or must be structurally compatible. Incompatible values: [:joins]

核心原因 #

Rails的.or()要求合并的两个查询结构完全一致，包括joins、select、includes等子句。上述代码中一个查询关联parent1，另一个关联parent2，导致joins结构不匹配，触发错误。

解决方案 #

场景1：同一父条件匹配parent1或parent2 #

需要同时关联两个父表（使用表别名避免冲突），然后将父条件分别映射到两个别名表，再用OR合并条件。

方式1：直接编写SQL片段

# 定义复用的父查询条件
parent_relation = Parent.where(status: :active).where("age > ?", 30)

# 构建基础查询，同时LEFT JOIN两个父表并指定别名
base_query = Child.where(**child_criteria)
                   .joins('LEFT JOIN parents AS parent1s ON parent1s.id = children.parent1_id')
                   .joins('LEFT JOIN parents AS parent2s ON parent2s.id = children.parent2_id')

# 将父条件分别适配到两个父表别名，再合并为OR逻辑
parent1_conditions = parent_relation.where_values.reduce(:and).dup.tap do |cond|
  cond.left = "parent1s.#{cond.left}"
end
parent2_conditions = parent_relation.where_values.reduce(:and).dup.tap do |cond|
  cond.left = "parent2s.#{cond.left}"
end

final_query = base_query.where(parent1_conditions.or(parent2_conditions))

方式2：用Arel实现（更安全的Rails风格）

parent1_table = Parent.arel_table.alias('parent1s')
parent2_table = Parent.arel_table.alias('parent2s')
child_table = Child.arel_table

# 构建关联逻辑
parent1_join = child_table.join(parent1_table, Arel::Nodes::OuterJoin)
                          .on(child_table[:parent1_id].eq(parent1_table[:id])).join_sources
parent2_join = child_table.join(parent2_table, Arel::Nodes::OuterJoin)
                          .on(child_table[:parent2_id].eq(parent2_table[:id])).join_sources

# 定义复用的父查询条件
parent_relation = Parent.where(status: :active).where("age > ?", 30)
# 将父条件映射到两个别名表
parent1_cond = parent_relation.where_values.reduce(:and).ast.to_sql.gsub('"parents"', parent1_table.name)
parent2_cond = parent_relation.where_values.reduce(:and).ast.to_sql.gsub('"parents"', parent2_table.name)

# 组装最终查询
final_query = Child.where(**child_criteria)
                   .joins(parent1_join, parent2_join)
                   .where("#{parent1_cond} OR #{parent2_cond}")

场景2：不同条件分别匹配parent1和parent2 #

同样需要保证两个分支查询的结构一致（都关联两个父表），再分别对对应父表应用条件，最后用.or()合并。

# 定义分别对应parent1和parent2的查询条件
parent1_relation = Parent.where(status: :active).where("age > ?", 30)
parent2_relation = Parent.where(status: :retired).where("age < ?", 70)

# 构建基础查询，同时关联两个父表
parent1_table = Parent.arel_table.alias('parent1s')
parent2_table = Parent.arel_table.alias('parent2s')
child_table = Child.arel_table

parent1_join = child_table.join(parent1_table, Arel::Nodes::OuterJoin)
                          .on(child_table[:parent1_id].eq(parent1_table[:id])).join_sources
parent2_join = child_table.join(parent2_table, Arel::Nodes::OuterJoin)
                          .on(child_table[:parent2_id].eq(parent2_table[:id])).join_sources

base_query = Child.where(**child_criteria).joins(parent1_join, parent2_join)

# 将条件映射到对应父表别名
parent1_cond = parent1_relation.where_values.reduce(:and).ast.to_sql.gsub('"parents"', parent1_table.name)
parent2_cond = parent2_relation.where_values.reduce(:and).ast.to_sql.gsub('"parents"', parent2_table.name)

# 构建两个结构一致的分支查询，再合并
query1 = base_query.where(parent1_cond)
query2 = base_query.where(parent2_cond)

final_query = query1.or(query2)

注意事项 #

• 若业务要求parent1和parent2必须存在，可将LEFT JOIN替换为INNER JOIN，避免返回父记录为空的Child。
• 若父查询是多条件OR组合，将reduce(:and)替换为reduce(:or)即可适配逻辑。
• 使用Arel的方式能避免硬写SQL的潜在风险，更适配Rails版本迭代。

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