Rails整合legacy_posts与posts到单ActiveRecord模型的方案咨询

你当前手动拼接UNION SQL的方案确实存在可维护性差、有SQL注入风险的问题，下面是几种Rails社区公认的更优实现方式：

方案1：使用ActiveRecord union扩展（最贴近现有逻辑，改造成本低） #

社区有通用的active_record_union扩展组件，专门用来处理ActiveRecord关系的联合查询，不需要手动拼接SQL片段，完全保留ActiveRecord的链式调用能力，避免SQL注入风险：

def combined_posts
  # 统一两个查询的字段数量、类型、别名，保证UNION合法性
  new_posts = user.posts.select(
    :id, 
    :title.as("heading"), 
    :content, 
    :posted_at,
    # 新增标记字段区分新旧数据，迁移阶段方便后续逻辑处理
    Arel.sql("'new' as record_source")
  )
  old_posts = user.legacy_posts.select(
    :id,
    :heading,
    :content,
    :posted_at,
    Arel.sql("'legacy' as record_source")
  )
  # 直接合并两个ActiveRecord关系，自动处理SQL拼接
  combined = old_posts.union(new_posts)
  # 排序、分页用法和原有逻辑完全一致
  combined.order(posted_at: :desc).page(params[:page] || 0).per(params[:items])
end

该方案后续调整字段只需要修改两个select部分即可，维护成本远低于手动拼SQL。

方案2：数据库视图封装（适合迁移周期较长的场景） #

如果迁移周期超过1个月，推荐把UNION逻辑封装到数据库视图中，单独创建只读的ActiveRecord模型对接视图，彻底把底层多表的逻辑和业务层解耦：

1. 生成迁移创建视图

class CreateCombinedPostsView < ActiveRecord::Migration[7.0]
  def up
    execute <<-SQL
      CREATE VIEW combined_posts AS
      SELECT 
        id, title as heading, content, posted_at, 'new' as record_source
      FROM posts
      UNION ALL -- 确定无重复数据时用UNION ALL比UNION性能高很多
      SELECT 
        id, heading, content, posted_at, 'legacy' as record_source
      FROM legacy_posts
    SQL
  end
  def down
    execute "DROP VIEW combined_posts"
  end
end

2. 创建对应只读模型 app/models/combined_post.rb

class CombinedPost < ApplicationRecord
  self.primary_key = 'id'
  # 标记为只读避免误写入视图
  def readonly?
    true
  end
  belongs_to :user
end

3. 控制器逻辑简化为：

def combined_posts
  user.combined_posts.order(posted_at: :desc).page(params[:page] || 0).per(params[:items])
end

该方案后续全量迁移完成后，只需要修改视图定义删掉legacy_posts相关逻辑即可，业务代码无需任何改动，过渡非常平滑。

通用注意事项 #

• 如果新旧表ID都是自增主键，UNION后会出现ID重复问题，建议在联合查询时把主键处理为CONCAT(record_source, '_', id)，避免ActiveRecord查询冲突
• 排序、筛选字段要提前统一别名，避免查询失效

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