Rails多对多关联查询报错：PG::UndefinedColumn: services.zip_code不存在

我帮你分析下这个问题——你遇到的报错主要是因为Rails默认的关联查询逻辑和你自定义的zip_code关联不匹配，再加上模型和迁移里的几个小错误。咱们一步步来解决：

第一步：修正迁移中的错误与冗余 #

先看你的迁移代码，有两处明显问题：

• Towns表中的stirng是拼写错误，应该是string
• services_towns表同时生成了town_id（来自t.belongs_to :town）和zip_code字段，这完全冗余——你用zip_code关联Town，根本不需要town_id

修正后的迁移代码：

create_table :services, type: :uuid do |t|
  t.string :name, null: false
  t.string :action, null: false
  t.string :kind, null: false
end

create_table :towns do |t|
  t.string :name, null: false
  t.string :zip_code, null: false # 修正拼写错误
  t.string :country, null: false
  # 给zip_code加唯一索引，确保每个城镇的邮编唯一
  t.index :zip_code, unique: true
end

create_table :services_towns do |t|
  t.belongs_to :service, type: :uuid # 匹配Service的uuid类型
  t.string :zip_code, null: false
  t.index :zip_code
  # 加唯一索引避免同一个服务重复关联同一个邮编
  t.index [:service_id, :zip_code], unique: true
end

第二步：修正模型关联的拼写与定义 #

你的模型里有拼写错误（services_communes应该是services_towns），而且Service关联Towns时，必须明确告诉Rails用zip_code作为关联键，而不是默认的id：

class Town < ApplicationRecord
  # 用zip_code作为主键关联中间表
  has_many :services_towns, primary_key: :zip_code, foreign_key: :zip_code
  has_many :services, through: :services_towns
end

class Service < ApplicationRecord
  has_many :services_towns
  has_many :towns, through: :services_towns,
           source: :town,
           primary_key: :zip_code,
           foreign_key: :zip_code
end

class ServicesTown < ApplicationRecord
  belongs_to :service
  # 明确用zip_code关联Town，不需要town_id字段
  belongs_to :town, primary_key: :zip_code, foreign_key: :zip_code
end

第三步：正确执行复杂查询 #

原来的Service.where(towns: [towns_array])报错，是因为Rails默认会尝试用id关联Towns，而你的关联逻辑是基于zip_code。你需要通过中间表的zip_code来实现查询：

# 获取传入城镇数组关联的所有服务
town_zip_codes = towns_array.pluck(:zip_code)
services = Service.joins(:services_towns)
                  .where(services_towns: { zip_code: town_zip_codes })
                  .distinct # 去重，避免同一个服务被多次返回

如果你想保留更简洁的调用方式，可以给Service添加一个scope：

class Service < ApplicationRecord
  # ... 其他关联代码
  scope :for_towns, ->(towns) {
    joins(:services_towns).where(services_towns: { zip_code: towns.pluck(:zip_code) }).distinct
  }
end

# 使用方式
services = Service.for_towns(towns_array)

为什么原来的查询会报错？ #

当你执行Service.where(towns: towns_array)时，Rails会默认生成基于id的关联SQL：

JOIN towns ON services_towns.town_id = towns.id
WHERE towns.id IN (...)

但你的关联并没有使用town_id，而是用zip_code，所以Rails找不到对应的关联字段，最终抛出了PG::UndefinedColumn错误。通过明确关联的primary_key和foreign_key，并通过中间表的zip_code查询，就能彻底解决这个问题。

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