Rails 7中重构MySQL CASE-WHEN-ELSE-END Scope方法的正确实现

问题背景 #

我在将应用升级到Rails 7时，需要重构订单相关的Scope查询方法。之前的Scope写法在Rails 7中触发了安全错误，而尝试用新增的in_order_of方法又会过滤掉不需要排除的记录。

原Rails版本的Scope（保留所有记录，仅按指定author_id排序）：

scope.order(sanitize_sql_array(["CASE articles.author_id WHEN ? THEN 1 ELSE 2 END", author.id]))

升级到Rails 7后触发的错误：

ActiveRecord::UnknownAttributeReference (Dangerous query method
(method whose arguments are used as raw SQL) called with non-attribute
argument(s): "CASE articles.author_id WHEN '3784' THEN 1 ELSE 2
END". This method should not be called with user-provided values, such
as request parameters or model attributes. Known-safe values can be
passed by wrapping them in Arel.sql().):

尝试用in_order_of改写后的问题：

scope.in_order_of(:author_id, [author.id])

该方法会自动添加WHERE articles.author_id IN (3784)子句，导致非指定author_id的记录被过滤，不符合原需求。

解决方案 #

以下几种方式都能实现和原CASE逻辑完全一致的效果：保留所有记录，仅将指定author_id的记录排在最前面。

1. 用Arel.sql包裹原CASE表达式（最贴近原逻辑）

直接按照错误提示，将CASE语句用Arel.sql包裹，同时安全传入参数：

scope.order(Arel.sql("CASE articles.author_id WHEN ? THEN 1 ELSE 2 END"), author.id)

或者结合sanitize_sql_array进一步确保参数安全：

scope.order(Arel.sql(sanitize_sql_array(["CASE articles.author_id WHEN ? THEN 1 ELSE 2 END", author.id])))

这种写法生成的SQL和原逻辑完全一致，不会添加额外WHERE条件，所有记录都会保留。

2. 用Arel API构建CASE表达式（纯ORM方式）

如果不想手写SQL字符串，可以用Rails的Arel接口构建CASE逻辑：

author_id_column = Article.arel_table[:author_id]
case_expression = Arel::Nodes::Case.new(author_id_column)
case_expression.when(author.id).then(1)
case_expression.else(2)
scope.order(case_expression)

这种方式完全通过ORM生成SQL，避免手写SQL的潜在问题，风格更统一。

3. 利用MySQL的FIELD函数（简洁写法）

针对MySQL环境，可以用FIELD函数实现相同排序效果，写法更简洁：

scope.order(Arel.sql("FIELD(articles.author_id, ?) DESC"), author.id)

FIELD函数会返回指定值在列表中的位置，DESC排序后，指定author_id的记录会排在最前面，其他记录按默认顺序排列，和原CASE逻辑效果一致。

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