ActiveRecord关联模型含两个belongs_to时has_one的配置问题

ActiveRecord 中的 has_one 关联默认会根据关联模型名自动推断外键为当前模型小写_id，也就是 Address 模型的 has_one :user 会默认给查询条件加上 users.address_id = 当前address.id，就算你传入了自定义 scope，这个默认生成的外键查询条件依然会被拼接进去，所以才会触发users.address_id 不存在的报错。

方案1：不修改现有表结构 #

如果不想调整当前的表字段设计，有两种可行方式：

• 直接使用自定义实例方法，逻辑简单直观，适合小项目临时使用：

class Address < ApplicationRecord
  def user
    User.find_by("home_address_id = ? OR work_address_id = ?", id, id)
  end
end

• 如果一定要保留 has_one 关联定义，可以手动移除默认拼接的外键条件：

class Address < ApplicationRecord
  has_one :user,
    ->(address) { unscope(where: :address_id).where(home_address_id: address.id).or(where(work_address_id: address.id)) },
    class_name: User.name
end

方案2：重构关联设计（更推荐） #

新增address_type字段的方案是更符合Rails最佳实践的实现，有两个明显优势：

1. 后续扩展地址类型（比如账单地址、收件地址）不需要新增表字段，只需要加枚举值即可
2. 关联逻辑符合ActiveRecord的默认约定，不需要写自定义查询逻辑，后续维护成本更低
   对应的完整实现如下：

第一步：新增字段迁移 #

class AddAddressTypeToAddresses < ActiveRecord::Migration[5.2]
  add_column :addresses, :address_type, :string
  # 建议同时加user_id字段，用来存储关联的用户id，符合has_many的关联约定
  add_reference :addresses, :user, foreign_key: true
end

第二步：调整模型关联 #

如果使用Enumerize gem管理枚举值：

class User < ApplicationRecord
  has_many :addresses, dependent: :destroy
  has_one :home_address, -> { home.order(created_at: :desc) }, class_name: Address.name
  has_one :work_address, -> { work.order(created_at: :desc) }, class_name: Address.name
end

class Address < ApplicationRecord
  extend Enumerize

  TYPE_HOME = 'home'
  TYPE_WORK = 'work'
  TYPES = [TYPE_HOME, TYPE_WORK]

  enumerize :address_type, in: TYPES, scope: :shallow
  # Shallow scope 允许直接调用 Address.home / Address.work 筛选对应类型的地址

  belongs_to :user

  # 根据业务需求加唯一性校验：这里仅要求每个用户的工作地址唯一
  validates_uniqueness_of :address_type, scope: :user_id, if: -> { address_type == TYPE_WORK }
end

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