Rails中如何限制Home关联最多3个Phone并显示友好错误？

问题背景 #

开发预订应用时，需要限制每个Home最多关联3个Phone，并在创建Phone的表单中显示友好错误提示。当前通过HomesPhone模型添加验证的方式会抛出ActiveRecord::RecordInvalid异常，无法满足表单友好提示的需求。

解决方案 #

1. 在Home模型中添加关联前验证 #

将数量限制逻辑放在Home模型中，通过before_add回调在关联Phone前检查数量，把错误直接绑定到Phone对象上，确保表单能捕获到错误信息：

class Home < ApplicationRecord
  has_many :homes_phones, dependent: :destroy
  has_many :phones, through: :homes_phones

  # 关联Phone前验证数量限制
  before_add :validate_phone_limit

  private

  def validate_phone_limit(phone)
    if phones.size >= 3
      # 给Phone对象添加错误提示，用于表单显示
      phone.errors.add(:base, "该房源最多只能关联3个电话号码")
      # 终止关联操作，不抛出异常
      throw :abort
    end
  end
end

2. 移除HomesPhone模型中的冗余验证 #

删除HomesPhone里原有的数量验证逻辑，避免重复验证：

class HomesPhone < ApplicationRecord
  belongs_to :home
  belongs_to :phone
  # 移除原有的 validate :check_phones_limit 代码
end

3. 修正测试用例 #

原测试用例使用create方法会在验证失败时抛出异常，改用build + save的方式，确保测试能正常验证Phone的无效状态：

it 'should limit phones to 3' do
  user = create(:user)
  home = create(:home, :active, manager: user)
  expect(home.phones.create(user: user, number: "+33611223344")).to be_valid
  expect(home.phones.create(user: user, number: "+33611223345")).to be_valid
  expect(home.phones.create(user: user, number: "+33611223346")).to be_valid

  # 构建Phone对象并尝试保存，不触发异常
  phone = home.phones.build(user: user, number: "+33611223347")
  expect(phone.save).to be false
  expect(phone).to be_invalid
  expect(phone.errors[:base]).to include("该房源最多只能关联3个电话号码")
end

4. 表单显示错误提示 #

在创建Phone的表单视图中，直接输出Phone对象的错误信息即可：

<% if @phone.errors.any? %>
  <div id="error_explanation">
    <h2><%= pluralize(@phone.errors.count, "错误") %> 阻止该电话号码保存：</h2>
    <ul>
      <% @phone.errors.full_messages.each do |msg| %>
        <li><%= msg %></li>
      <% end %>
    </ul>
  </div>
<% end %>

原理说明 #

原实现的问题在于：执行home.phones.create时，会先创建Phone实例，再创建HomesPhone关联记录，此时HomesPhone验证失败会抛出异常，导致事务回滚，但异常会向上冒泡，无法让Phone实例携带错误信息返回给表单。

通过Home的before_add回调，在关联添加之前就完成数量检查，将错误绑定到Phone对象上，再用throw :abort终止关联操作，既不会创建无效的关联记录，也能让Phone实例携带错误信息，完美适配表单的友好提示需求。

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