Where子句中的关联引用是否都需复数化？Rails版本升级疑问

问题重现 #

将Rails 3（Ruby 1.9.3）应用升级到Rails 7（Ruby 3.2.2）后，执行关联查询时遇到SQL错误：
执行Request.joins(job: :quote).to_sql生成符合预期的JOIN语句：

SELECT "requests".* FROM "requests"
INNER JOIN "jobs" ON "jobs"."id" = "requests"."job_id"
INNER JOIN "quotes" ON "quotes"."job_id" = "jobs"."id"

但添加WHERE嵌套条件后：

Request.joins(job: :quote).where(job: {quote: {attachment_updated_at: nil}}).to_sql

生成的SQL出现异常，WHERE子句引用了未声明的quote表别名：

SELECT "requests".* FROM "requests"
INNER JOIN "jobs" "job" ON "job"."id" = "requests"."job_id"
INNER JOIN "quotes" ON "quotes"."job_id" = "job"."id"
WHERE "quote"."attachment_updated_at" IS NULL

执行时触发错误：ERROR: missing FROM-clause entry for table "quote"

疑问解答 #

1. 为什么WHERE子句会改变JOIN语句？ #

Rails Active Record在处理WHERE子句中的嵌套哈希关联条件时，会自动为关联表添加单表别名（比如这里把jobs表别名为job），这是新版本Rails优化关联条件解析的默认行为，用于在复杂多关联查询中区分不同的表引用。但你使用单数quote作为嵌套键时，Rails错误地将其解析为quotes表的别名，而实际JOIN语句中并没有给quotes表指定这个别名，导致WHERE子句引用了不存在的表别名，最终触发SQL错误。

2. WHERE子句中的关联引用是否都需要复数化？ #

不是强制要求全部复数化，核心是要匹配Rails的解析逻辑：

• 如果是通过关联名称嵌套条件，需使用定义关联时的名称（has_one关联用单数，has_many用复数），但这种方式在已显式执行joins的场景下，容易出现别名解析冲突。
• 更稳妥的方式是直接使用表名的复数形式编写条件，这样Rails会直接引用原始表名，不会生成多余的别名，避免混淆。比如把条件改成：

  Request.joins(job: :quote).where(quotes: { attachment_updated_at: nil })
  

  这样生成的SQL会正确引用quotes表，不会出现别名问题。

另外，也可以使用字符串形式的条件明确指定表名：

Request.joins(job: :quote).where('quotes.attachment_updated_at IS NULL')

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