Rails中如何将User模型的scope应用到Payment关联查询中

基础正确写法 #

要在Payment的查询逻辑中套用User模型的exclude_superadmins scope，需要先明确关联两张数据表，再通过Rails提供的merge方法将关联模型的查询条件合并到当前查询集，完整可运行的代码如下：

@payments = Payment.approved
                   .current_month
                   .joins(:user)
                   .merge(User.exclude_superadmins)

之前尝试未生效的常见原因 #

• 仅使用includes(:user)做关联时，Rails默认会触发独立的预加载查询流程，关联模型的过滤条件不会拼接到Payment的主查询SQL中，无法实现排除效果，这种场景需要搭配references(:user)才能让关联过滤逻辑正常生效
• 没有先通过joins建立两张表的SQL内关联，直接调用merge方法时查询上下文中不存在users表引用，会触发SQL字段找不到的运行时报错

可维护性优化 #

可以把这段关联过滤逻辑封装为Payment模型自带的scope，避免每次编写查询时重复写关联代码：
在app/models/payment.rb文件中新增scope定义：

# 排除超级管理员用户产生的付款记录
scope :exclude_superadmin_payments, -> { joins(:user).merge(User.exclude_superadmins) }

封装完成后，业务层的查询可以保持简洁的链式调用形式：

@payments = Payment.approved.current_month.exclude_superadmin_payments

这种封装方式的好处是，后续如果exclude_superadmins的超级管理员判定逻辑发生调整（比如修改判定字段、变更权限等级阈值），只需要修改User模型中的原scope定义，所有关联Payment的查询都会自动同步最新的过滤规则，不需要在各业务代码中零散修改重复的判断逻辑。

注意事项 #

• 直接在Payment的查询对象上链式调用exclude_superadmins会触发之前遇到的NoMethodError，因为该scope定义在User模型上，Payment的查询上下文无法直接调用跨模型的实例方法
• 如果后续需要在视图中渲染付款对应的用户信息，只需要在查询链末尾追加.includes(:user)即可，因为已经通过joins建立了表关联，预加载逻辑会正常生效，不会产生多余的重复数据库查询

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