Ruby on Rails执行inner join子查询SQL报near 'on'语法错误如何解决

将完整原生SQL查询语句直接传入ActiveRecord的select方法是报错的核心原因。
Rails中select方法仅用于指定查询返回的字段，框架会自动在生成的SQL中拼接FROM 模型对应表名的基础片段，最终生成的SQL会多出多余的FROM "products"后缀，和传入的SQL片段拼接后出现语法冲突，触发on关键字附近的语法报错。
当前错误写法最终生成的异常SQL结构如下：

SELECT * FROM products p inner join (SELECT product_id, AVG(rating) as avg_rating
FROM reviews GROUP BY product_id) as x on p.id = x.product_id ORDER BY x.avg_rating DESC FROM "products"

末尾冗余的FROM "products"为框架自动拼接内容，直接破坏了SQL语法结构。

方案1：ActiveRecord链式写法（推荐） #

保留ORM链式调用能力，方便后续追加筛选、分页等逻辑：

# 构造评论平均分子查询
avg_rating_subquery = Review.select("product_id, AVG(rating) as avg_rating")
                            .group(:product_id)
                            .to_sql

@products = Product.joins("INNER JOIN (#{avg_rating_subquery}) AS review_stats ON products.id = review_stats.product_id")
                   .select("products.*, review_stats.avg_rating")
                   .order("review_stats.avg_rating DESC")

该写法返回的Product实例可以直接调用avg_rating属性读取对应商品的平均评分，不会出现SQL拼接错误。

方案2：直接执行全量原生SQL #

不需要后续链式调用时，可以使用find_by_sql直接执行完整自定义SQL，框架不会自动拼接额外片段：

@products = Product.find_by_sql(<<~SQL)
  SELECT p.*, x.avg_rating
  FROM products p
  INNER JOIN (
    SELECT product_id, AVG(rating) AS avg_rating
    FROM reviews
    GROUP BY product_id
  ) AS x ON p.id = x.product_id
  ORDER BY x.avg_rating DESC
SQL

• 商品数据量较大时，建议给reviews表的product_id字段加索引，避免分组查询触发全表扫描
• 如果需要将无评论的商品也纳入列表，可以将INNER JOIN替换为LEFT JOIN，同时用COALESCE将无评论商品的平均评分置为0，避免NULL值打乱排序逻辑，参考写法：

avg_rating_subquery = Review.select("product_id, AVG(rating) as avg_rating")
                            .group(:product_id)
                            .to_sql

@products = Product.joins("LEFT JOIN (#{avg_rating_subquery}) AS review_stats ON products.id = review_stats.product_id")
                   .select("products.*, COALESCE(review_stats.avg_rating, 0) AS avg_rating")
                   .order("avg_rating DESC")

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