Rails如何强制ActiveRecord关联始终生成表别名解决多STI查询错误

项目中使用单表继承（STI）机制，基类为Item，包含Item1到Item5共5个子类。STI对应的items表通过中间表item_parents，以has_many through:方式关联Parent模型对应的parents表。
所有Item子类都包含name、code两个字符串类型字段；Parent模型简化为name、created_at两个字段。前端将关联数据统一展示在单张表格中，列结构如下：
Parent.name | Parent.created_at | Item1.name | Item1.code | Item2.name | Item2.code | ...
用户可对任意列配置过滤规则，支持任意规则组合（包括不设置任何过滤），示例过滤组合：

Parent.created_at before 2020.02.22
Item1.name containing 'abc'
Item2.name containing 'xyz'
Item3.code equals 'Z12'

现有过滤逻辑实现：

def search(filters)
  filters.reduce(Parent.all) { |query, (key, value)| apply_filter(query, key, value) }
end

def apply_filter(query, key, value)
  case filter_key
  when :parent_name_contains
    query.where(Parent.arel_table[:name].matches("%#{value}%"))
  when :parent_created_at_before
    query.where(Parent.arel_table[:created_at].lt(value))
  when :item1_name_contains
    query.joins(:item1s).where(Item1.arel_table[:name].matches("%#{value}%"))
  when :item2_name_contains
    query.joins(:item2s).where(Item2.arel_table[:name].matches("%#{value}%"))
  when :item1_code_equals
    query.joins(:item1s).where(Item1.arel_table[:name].eq(value))
  when :item2_code_equals
    query.joins(:item2s).where(Item2.arel_table[:name].eq(value))
  # ... 其余过滤条件逻辑一致
  else
    query
  end
end

同时对2个及以上不同Item子类的字段设置查询过滤条件时，ActiveRecord无法生成正确的WHERE子句：JOIN子句中为关联表分配的别名，不会被WHERE子句正确引用。
例如过滤Item1.name = 'i1'且Item2.name = 'i2'时，Rails生成的SQL如下：

SELECT "parents".*
FROM "parents"
         INNER JOIN "item_parents"
                    ON "item_parents"."parent_id" = "parents"."id"
         INNER JOIN "items"
                    ON "items"."id" = "item_parents"."item_id"
                        AND "items"."item_type" = 'Item::Item1'

         INNER JOIN "item_parents" "item_parents_parents_join"
                    ON "item_parents_parents_join"."parent_id" = "parents"."id"
         INNER JOIN "items" "item2s_parents" -- JOIN阶段已生成正确别名
                    ON "item2s_parents"."id" = "item_parents_parents_join"."item_id"
                        AND "item2s_parents"."item_type" = 'Item::Item2'

WHERE "items"."name" = 'i1' 
  AND "items"."name" = 'i2' -- 引用错误，此处应为"item2s_parents"."name" = 'i2'

该SQL最终会返回0条结果，逻辑上不存在同一条item记录的name同时等于'i1'和'i2'的情况。

曾编写自定义joins_item方法：遍历查询对象，检查此前是否调用过其他join关联（ActiveRecord会将关联信息存储在query.values[:joins]和query.values[:left_outer_joins]中），若存在已关联的表则返回携带正确别名的Arel::Table实例，若无已关联表则返回默认无别名的Arel::Table。
但测试后发现ActiveRecord是在最终生成SQL的阶段才解析别名，即使在调用join时能预判正确别名（或无别名），最终生成SQL时别名仍可能发生变化。典型场景为先调用left_outer_joins再调用joins时，ActiveRecord始终会将INNER JOIN放在LEFT OUTER JOIN之前，导致预先判断的别名匹配失效。

是否存在可行方案，可强制ActiveRecord在使用Arel调用joins或left_outer_joins时，像Java中的Hibernate一样始终为关联表生成别名（而非仅在存在歧义时才生成别名）？或是有其他可维护性较好的 workaround、修复方案、猴子补丁可以解决该问题？

不要依赖ActiveRecord自动生成的别名，手动定义带固定别名的Arel Join节点是可维护性最高的方案，无需打猴子补丁，也不会受ActiveRecord内部Join重排序逻辑影响，从根源避免别名不匹配问题。

实现逻辑 #

• 提前为每个Item子类关联分配全局唯一的固定表别名，比如Item1关联的items表别名为items_item1，对应中间表item_parents别名为ip_item1，所有别名全局不重复。
• 封装通用Join构造方法，需要关联某类Item时，直接用固定别名构造Join节点，WHERE条件也直接引用对应固定别名的Arel表对象，完全绕开ActiveRecord的自动别名生成逻辑。
• 增加重复Join判断，已经加入过的关联不需要重复拼接。

示例代码：

# 固定别名配置，全局唯一不重复
ITEM_ASSOC_ALIASES = {
  item1: { items: "items_item1", item_parents: "ip_item1" },
  item2: { items: "items_item2", item_parents: "ip_item2" },
  item3: { items: "items_item3", item_parents: "ip_item3" },
  item4: { items: "items_item4", item_parents: "ip_item4" },
  item5: { items: "items_item5", item_parents: "ip_item5" }
}.freeze

# 构造指定Item关联的带别名Inner Join节点
def build_item_join(assoc_name)
  conf = ITEM_ASSOC_ALIASES[assoc_name]
  item_klass = assoc_name.to_s.classify.constantize
  parents = Parent.arel_table
  ip = ItemParent.arel_table.alias(conf[:item_parents])
  items = Item.arel_table.alias(conf[:items])

  # 拼接中间表关联
  join_ip = ip.create_join(
    ip,
    ip.create_on(ip[:parent_id].eq(parents[:id])),
    Arel::Nodes::InnerJoin
  )
  # 拼接items表关联，带上STI类型过滤
  join_items = items.create_join(
    items,
    items.create_on(
      items[:id].eq(ip[:item_id]).and(items[:type].eq(item_klass.name))
    ),
    Arel::Nodes::InnerJoin
  )

  [join_ip, join_items]
end

# 改造过滤逻辑
def apply_filter(query, key, value)
  case key
  when :parent_name_contains
    query.where(Parent.arel_table[:name].matches("%#{value}%"))
  when :parent_created_at_before
    query.where(Parent.arel_table[:created_at].lt(value))
  when :item1_name_contains
    items = Item.arel_table.alias(ITEM_ASSOC_ALIASES[:item1][:items])
    query.joins(build_item_join(:item1)).where(items[:name].matches("%#{value}%"))
  when :item2_name_contains
    items = Item.arel_table.alias(ITEM_ASSOC_ALIASES[:item2][:items])
    query.joins(build_item_join(:item2)).where(items[:name].matches("%#{value}%"))
  when :item1_code_equals
    items = Item.arel_table.alias(ITEM_ASSOC_ALIASES[:item1][:items])
    query.joins(build_item_join(:item1)).where(items[:code].eq(value))
  when :item2_code_equals
    items = Item.arel_table.alias(ITEM_ASSOC_ALIASES[:item2][:items])
    query.joins(build_item_join(:item2)).where(items[:code].eq(value))
  # 其余子类过滤逻辑按相同模式扩展即可
  else
    query
  end
end

如果需要避免重复Join，可以在query上挂载临时标记，记录已经拼接的关联，后续同关联过滤直接复用已有别名表对象加条件即可，不需要重复Join。

不推荐的方案 #

• 猴子补丁修改ActiveRecord的别名生成逻辑：ActiveRecord的别名生成和Join去重、关联预加载、SQL排序等多个内部模块强耦合，硬改容易引入隐蔽bug，后续Rails版本升级也会存在兼容问题。
• 预判ActiveRecord自动生成的别名：如测试结果所示，ActiveRecord在SQL生成最后阶段才会确定最终别名，Join顺序调整、内外Join混合都会改变别名结果，预判逻辑稳定性极差。

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