Rails 6中关联CalendarDayRequest与Volunteer时报错排查

你遇到的问题根源在于**Volunteer模型的default_scope导致关联查询时缺少必要的表引用**。

当你定义Volunteer < User时，添加了这个默认作用域：

default_scope {joins(:roles).where("roles.name=?", 'volunteer')}

这个作用域会自动应用到所有Volunteer相关的查询中——包括从CalendarDayRequest关联查询volunteer的时候。

当执行CalendarDayRequest.joins(:volunteer)时，ActiveRecord尝试生成的SQL是：

SELECT "calendar_day_requests".* FROM "calendar_day_requests" 
INNER JOIN "users" ON (roles.name='volunteer') AND "users"."id" = "calendar_day_requests"."volunteer_id"

这里的问题很明显：SQL里引用了roles.name，但没有将roles表加入到FROM/JOIN子句中，所以PostgreSQL报错提示找不到roles表的条目。

这里有几种可行的修复方案，按推荐程度排序：

1. 移除default_scope，改用显式的普通Scope #

default_scope的隐式全局行为很容易引发这类关联查询的问题，推荐用普通Scope替代：

class Volunteer < User
  # 定义一个显式的scope，只在需要筛选志愿者时调用
  scope :with_volunteer_role, -> { joins(:roles).where(roles: { name: 'volunteer' }) }
  # 更安全的Arel写法（避免SQL注入风险）：
  # scope :with_volunteer_role, -> { joins(:roles).where(Role.arel_table[:name].eq('volunteer')) }

  has_many :calendar_day_requests
end

之后查询志愿者时，用Volunteer.with_volunteer_role，而关联查询CalendarDayRequest.joins(:volunteer)会正常工作，不会自动带上roles的筛选条件。

2. 保留default_scope，但在关联查询时手动补充join #

如果你必须保留default_scope，可以在查询CalendarDayRequest时手动joinroles表：

# 手动join volunteer的roles表，满足default_scope的条件
CalendarDayRequest.joins(volunteer: :roles)

或者修改CalendarDayRequest的关联定义，提前带上必要的join：

class CalendarDayRequest < ApplicationRecord
  belongs_to :volunteer, 
             -> { joins(:roles).where(roles: { name: 'volunteer' }) }, 
             class_name: 'User', 
             optional: true
end

不过这种方式会让每次关联查询都带上roles的join，可能影响性能，且不如第一种方案清晰。

3. 改用Rails单表继承（STI）的标准实现 #

如果你的设计意图是用STI区分普通用户和志愿者，那更规范的做法是给users表添加type字段，让Rails自动处理类型筛选：

首先生成迁移添加type字段：

class AddTypeToUsers < ActiveRecord::Migration[6.1]
  def change
    add_column :users, :type, :string
  end
end

然后修改Volunteer模型，移除default_scope：

class Volunteer < User
  # Rails会自动筛选users.type = 'Volunteer'的记录
  has_many :calendar_day_requests
end

这种方式完全避免了roles表的关联筛选问题，符合Rails STI的设计规范。

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