Rails 4+参数化子查询预编译语句显示$1而非替换参数的解决方法

Rails 4.2+ 开始，对 ActiveRecord 关系调用 .to_sql 时，子查询里的参数会保留占位符（比如 $1），不会像 Rails 3 那样直接替换成实际值。这种变化会导致把这类子查询SQL手动拼进更大的查询时，因占位符未替换而执行失败。下面是几种可行的调整方案：

• 优先用ActiveRecord关系对象嵌套，避免手动拼接SQL
  这是最稳妥的方式，直接把子查询的关系对象传入主查询，让Rails自动处理参数绑定，根本不会出现占位符问题：

  # 定义子查询关系对象
  subquery_relation = ExampleModel.where(network_id: 5150)
  # 直接将关系对象传入主查询，而非拼接to_sql的结果
  MainModel.where(id: subquery_relation.select(:main_model_id))
  

  Rails会自动生成包含正确参数绑定的完整SQL，无需手动处理占位符。

• 若必须手动拼接SQL，主动替换占位符
  如果因为特殊场景必须用字符串拼接，那就主动提取关系对象的绑定参数，手动替换占位符，记得用数据库连接的quote方法处理参数，防止SQL注入：

  relation = ExampleModel.where(network_id: 5150).as("subquery")
  raw_sql = relation.to_sql
  # 根据数据库适配占位符格式，PostgreSQL是$n，MySQL是?
  processed_sql = raw_sql.gsub(/\$(\d+)/) do |match|
    # 取对应位置的参数并转义
    relation.connection.quote(relation.bind_values[$1.to_i - 1])
  end
  

  注意不同数据库的占位符格式不同，需要根据实际使用的适配器调整正则表达式。

• 用Arel构建子查询
  借助Rails底层的Arel库来构建查询，它能更精准地处理参数绑定和SQL生成，避免手动拼接的坑：

  example_table = ExampleModel.arel_table
  # 用Arel构建子查询
  subquery = example_table.project(Arel.star)
                          .where(example_table[:network_id].eq(5150))
                          .as("subquery")
  # 将Arel对象整合进主查询
  MainModel.joins(Arel.sql(subquery.to_sql)).to_sql
  

  Arel会自动管理参数的占位符与实际值的映射，生成的SQL可以安全嵌入主查询。

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