Rails中has_many :through关联按日期查询Author记录的解决方法

问题背景 #

需要基于has_many :through关联的书籍发布日期字段，筛选出对应书籍在指定日期区间内的作者列表，原有查询逻辑运行失效。

失效的原查询代码 #

start_date = '01/01/0001'.to_date.beginning_of_day
end_date = '01/01/2020'.to_date.end_of_day

Author.includes(:books).where("date(books.release_date) BETWEEN ? AND ?", start_date, end_date)

已验证可用的单表查询 #

以下针对Book表的日期区间查询可以正常返回结果：

Book.where("date(release_date) BETWEEN ? AND ?", start_date, end_date)

原查询失效原因 #

includes是Rails的预加载方法，默认采用两次独立查询的执行策略：先查询主表Author记录，再根据外键批量查询关联的Book记录。整个过程不会在主查询中JOIN books表，此时直接在where条件中引用books.release_date字段，会抛出missing FROM-clause entry for table "books"的SQL错误。
即便触发了includes的自动JOIN逻辑，也会出现重复返回作者记录的问题——一个作者如果有多本符合日期条件的书籍，就会在结果集中出现多次。

最优实现代码 #

基础过滤版本（仅返回符合条件的作者，无预加载） #

使用joins生成内连接，配合distinct去重，是这类关联过滤场景的标准写法：

start_date = '01/01/0001'.to_date.beginning_of_day
end_date = '01/01/2020'.to_date.end_of_day

Author.joins(:books)
      .where(books: { release_date: start_date..end_date })
      .distinct

说明：直接用时间范围匹配而不套date()函数，可以命中books.release_date字段上的数据库索引，查询性能更高。由于end_date已经取到了当日23:59:59，范围匹配的结果和date()转换后的查询结果完全一致。

预加载优化版本（同时加载关联书籍，避免N+1查询） #

如果查询后还需要访问每个作者关联的books属性，可以同时加上includes做预加载：

Author.joins(:books)
      .includes(:books)
      .where(books: { release_date: start_date..end_date })
      .distinct

如果是has_many :through关联，只要Author模型中正确定义了和Book的关联关系，joins(:books)会自动处理中间表的JOIN逻辑，不需要手动指定中间表。

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