Rails中如何实现articles.includes(:tags)按小写标签名关联查询

报错原因 #

你遇到的报错是因为 includes(:tags) 默认采用分两次查询的预加载策略（先查符合条件的articles，再根据article ID批量查关联的tags），不会自动把tags表join到articles的主查询中，所以主查询的WHERE子句里引用tags.name时SQL找不到对应的表，触发missing FROM-clause entry for table "tags"错误。

解决方法 #

你可以通过以下几种方式实现SQL层的过滤，同时保留预加载避免N+1查询问题，逻辑和你原有内存筛选完全等价：

方案1：includes + references 声明关联表依赖

主动告诉Rails你需要在WHERE条件中使用tags表的字段，强制将tags表join到主查询：

def articles_tagged_with(x)
  user.articles.includes(:tags)
    .where('lower(tags.name) = ?', x.downcase)
    .references(:tags)
    .distinct # 避免同一篇文章匹配多个标签时返回重复记录
    .all
end

方案2：用eager_load强制左外连接

eager_load是Rails提供的强制左外连接关联表+预加载的方法，不需要额外加references：

def articles_tagged_with(x)
  user.articles.eager_load(:tags)
    .where('lower(tags.name) = ?', x.downcase)
    .distinct
    .all
end

方案3：joins+preload（仅需过滤时可选）

如果只需要筛选带对应标签的文章，不需要加载无标签的文章，也可以用内连接joins配合预加载：

def articles_tagged_with(x)
  user.articles.joins(:tags)
    .where('lower(tags.name) = ?', x.downcase)
    .preload(:tags)
    .distinct
    .all
end

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