RSpec中Rails关联方法行为异常问题排查求助

问题背景 #

在RSpec测试中，使用let/let!定义ActiveRecord对象后，调用关联方法时出现查询结果不一致的情况：部分关联数据仿佛"卡住"，显式调用find查询数据库能暂时解决，但在let、let!和before块中均存在不同程度的异常，希望用RSpec原生特性替代显式find的临时方案。

核心异常现象 #

1. let懒加载导致的计数差异 #

使用let定义对象时，同一应用实例的关联计数出现不一致：

RSpec.describe Form::Adaption, type: :model do
  context 'when a revision gets created' do
    let(:app) { create(:form_application, revision_counter: 1) } # 自动创建一个adaption
    let(:rev_adap) { create(:form_adaption, action_type: 'revision', application: app) }

    describe '关联计数异常' do
      it '同一实例关联计数不一致' do
        # 初始状态：
        puts "app.adaptions.count: #{app.adaptions.count}" # => 1
        puts "rev_adap.application.adaptions.count: #{rev_adap.application.adaptions.count}" # => 2
        puts "Form::Application.find(rev_adap.application_id).adaptions.count" # => 2 

        # 创建新关联后：
        create(:form_adaption, action_type: 'document', application: app)
        puts "app.adaptions.count: #{app.adaptions.count}" # => 3
        puts "rev_adap.application.adaptions.count: #{rev_adap.application.adaptions.count}" # => 3
        puts "Form::Application.find(rev_adap.application_id).adaptions.count" # => 3 
      end
    end
  end
end

2. let!非懒加载仍存集合为空问题 #

切换为let!后计数显示正常，但调用关联集合时返回空数组：

let!(:app) { create(:form_application, revision_counter: 1) }
let!(:rev_adap) { create(:form_adaption, action_type: 'revision', application: app) }

it '关联计数正常但集合为空' do
  post_revision_doc_adap = create(:form_adaption, action_type: 'document', application: app)
  puts "Adap count: #{app.adaptions.count}" # => 4（符合预期）
  pp app.adaptions.first # => nil
  app.adaptions.sample(1).revision_manager # 报错：undefined method `revision_manager' for []:Array
end

调试发现 #

• app.adaptions.count返回正确数值，但app.adaptions是空的Form::Adaption::ActiveRecord_Associations_CollectionProxy，仅包含表结构信息，无实际数据值。
• 该现象源于ActiveRecord的内存对象缓存：已加载的关联集合不会自动同步数据库新增的数据。

临时解决方案 #

通过自定义方法每次从数据库重新查询对象，避免内存缓存影响：

def app
  @__a ||= create(:form_application, revision_counter: 1)
  Form::Application.find(@__a.id)
end

def rev_adap
  @__a2 ||= create(:form_adaption, action_type: 'revision', application: app)
  Form::Adaption.find(@__a2.id)
end

但仍存在部分计数异常问题，且代码不够优雅。

优雅解决方案 #

1. 显式重载对象或关联 #

当需要获取最新关联数据时，调用reload方法刷新内存对象：

# 重载整个对象
app.reload.adaptions

# 仅重载关联集合
app.adaptions.reload

修改测试代码如下，即可解决集合为空问题：

it '重载关联后获取最新数据' do
  post_revision_doc_adap = create(:form_adaption, action_type: 'document', application: app)
  puts "Adap count: #{app.adaptions.count}"
  pp app.adaptions.reload.first # 正常返回数据
  app.adaptions.reload.sample(1).revision_manager # 执行成功
end

2. 调整let定义，避免缓存干扰 #

如果需要在多个测试中保持对象的最新状态，可以在let中直接返回查询结果，但注意这会每次调用都查询数据库：

let(:app) { Form::Application.find(create(:form_application, revision_counter: 1).id) }

但更推荐在需要时按需reload，而非全局强制查询，以平衡测试性能和正确性。

3. 检查FactoryBot钩子的影响 #

排查工厂代码中的after :create钩子，确保关联创建逻辑不会导致内存对象与数据库不同步：

• form_application工厂的after :create中通过AdaptionManager创建了一个Adaption，此时内存中的app对象并未自动加载该关联，首次调用app.adaptions时会缓存空集合，后续新增数据需要reload才能获取。

工厂代码参考 #

form/adaptions_factory.rb #

# frozen_string_literal: true

require "#{Rails.root}/lib/constants/test_constants"

FactoryBot.define do
  factory :form_adaption, class: 'Form::Adaption' do
    association :application, factory: :form_application
    association :user, factory: %i[user random]
    action_type { NO_ARGS_ACTION_TYPES.sample }
    deadline { 1.year.from_now }

    after :create, class: 'Form::Adaption' do |adap, _evaluator|
      adap.update(deadline: TestConstants::Adaption::DEADLINES[adap.action_type])
    end
  end
end

form/applications_factory.rb #

FactoryBot.define do
  factory :form_application, class: 'Form::Application' do
    association :student, factory: :student
    association :semester, factory: :semester

    after :create, class: 'Form::Application' do |app|
      user = create(:user, :random)
      AdaptionManager.new(user, app).create_application
    end
  end
end

测试环境 #

• Ruby 2.7.2
• Rails 6.0.6.1
• RSpec 3.12（rspec-core 3.12.1、rspec-expectations 3.12.2、rspec-mocks 3.12.3、rspec-rails 5.1.2、rspec-support 3.12.0）
• 依赖：factory_bot、db_cleaner

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