使用includes关联多对多记录并获取中间表属性报错的解决方法

错误原因 #

使用includes预加载passengers_with_ticket_type时，Rails会生成单独的SELECT查询获取乘客数据，该查询仅针对passengers表，未关联buses_passengers中间表，导致SELECT子句中的buses_passengers.ticket_type无法找到对应表，触发PG报错。而单条记录查询时，会基于Bus的ID自动关联中间表，因此能正常运行。

方案一：修改关联Scope并使用eager_load #

调整Bus模型中的passengers_with_ticket_type关联，显式关联中间表，同时用eager_load替代includes（eager_load会强制使用JOIN方式预加载，确保中间表被包含在查询中）：

class Bus < ApplicationRecord
  has_many :buses_passengers, dependent: :destroy, inverse_of: :bus
  has_many :passengers, through: :buses_passengers, inverse_of: :buses
  has_many :passengers_with_ticket_type, -> { 
    joins(:buses_passengers).select('passengers.*, buses_passengers.ticket_type') 
  },
           class_name: 'Passenger',
           through: :buses_passengers,
           source: :passenger
end

控制器中使用eager_load：

@buses = Bus.eager_load(:passengers_with_ticket_type).some_scope

视图逻辑保持不变即可正常获取passenger.ticket_type。

方案二：直接预加载中间表（更直观） #

放弃通过乘客对象获取中间表属性，改为直接预加载buses_passengers及关联的passenger，通过中间表记录获取ticket_type：

控制器修改：

@buses = Bus.includes(buses_passengers: :passenger).some_scope

视图遍历逻辑调整：

@buses.each do |bus|
  puts bus.attribute_1
  # ...其他巴士属性

  bus.buses_passengers.each do |bus_passenger|
    passenger = bus_passenger.passenger
    puts passenger.attribute_1
    # ...其他乘客属性
    puts bus_passenger.ticket_type # 直接从中间表获取票种
  end
end

此方法无需修改关联定义，逻辑更清晰，也避免了预加载时的SQL表缺失问题。

方案三：使用select_include（Rails 7.1+） #

如果使用Rails 7.1及以上版本，可以利用select_include特性直接在预加载时指定要包含的中间表属性：

class Bus < ApplicationRecord
  has_many :buses_passengers, dependent: :destroy, inverse_of: :bus
  has_many :passengers, through: :buses_passengers, inverse_of: :buses
end

控制器中：

@buses = Bus.includes(:passengers).select_include(
  passengers: { buses_passengers: [:ticket_type] }
).some_scope

视图中通过passenger.buses_passengers.find_by(bus_id: bus.id).ticket_type获取属性，但此方法在多巴士场景下效率略低，更适合单巴士查询。

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