Ruby on Rails关联查询中，如何按Package的Tracking字段过滤且避免重复？

针对你遇到的问题，这里提供两种可行的解决方案，同时解释问题根源：

问题根源 #

1. includes过滤报错：单独使用includes预加载时，Rails不会自动在主查询中关联关联表，直接在where中引用packages.tracking会导致数据库找不到对应表，抛出PG::UndefinedTable错误。
2. joins返回重复数据：joins默认生成内连接，一个Invoice对应多个匹配的Package时，查询结果会重复返回该Invoice对象，最终导致jbuilder渲染重复内容。

方案1：includes + references + distinct（兼顾预加载与去重） #

通过references强制Rails关联packages表，配合distinct去除重复的Invoice记录，同时用includes预加载所有关联数据避免N+1查询：

@invoices = Invoice.includes(packages: :additional_charges)
                   .references(:packages)
                   .where("packages.tracking LIKE ?", "%#{params[:tracking]}%")
                   .distinct
                   .page(params[:page])
                   .per(params[:per_page])

关键说明 #

• references(:packages)：告诉Rails在主查询中关联packages表，让where条件能正确识别packages.tracking字段。
• distinct：去除因多个Package匹配同一Invoice而产生的重复记录。
• includes(packages: :additional_charges)：一次性预加载Invoice关联的所有Package及对应的AdditionalCharge，保证API性能。

方案2：exists子查询（更高效的过滤方式） #

对于数据量较大的场景，使用exists子查询可以避免连接表带来的性能损耗，同时天然保证Invoice记录唯一：

@invoices = Invoice.includes(packages: :additional_charges)
                   .where(
                     Package.where("packages.invoice_id = invoices.id")
                             .where("packages.tracking LIKE ?", "%#{params[:tracking]}%")
                             .exists?
                   )
                   .page(params[:page])
                   .per(params[:per_page])

关键说明 #

• 子查询仅判断当前Invoice是否存在匹配的Package，不会返回重复的Invoice记录。
• 同样搭配includes预加载关联数据，确保渲染时无需额外查询数据库。

Jbuilder渲染注意事项 #

确保jbuilder模板是遍历去重后的@invoices集合，每个Invoice只渲染一次，示例如下：

# app/views/invoices/index.json.jbuilder
json.array! @invoices do |invoice|
  json.id invoice.id
  json.number invoice.number
  # 其他Invoice字段...

  json.packages invoice.packages do |package|
    json.id package.id
    json.tracking package.tracking
    # 其他Package字段...

    json.additional_charges package.additional_charges do |charge|
      json.id charge.id
      json.amount charge.amount
      # 其他AdditionalCharge字段...
    end
  end
end

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