Rspec中ActiveRecord includes未抛异常？开发环境却报错

核心原因 #

开发环境下，Rails默认对includes传入的关联名做严格校验，一旦发现不存在的关联，立刻抛出ActiveRecord::AssociationNotFoundError。但测试环境的默认配置未开启该严格校验，再加上测试事务的运行机制，导致无效关联不会触发异常，反而返回空集合。

解决办法 #

1. 全局开启测试环境的关联校验 #

在config/environments/test.rb中添加配置，让测试环境和开发环境保持一致的校验逻辑：

Rails.application.configure do
  # 保留原有配置，新增以下行
  config.active_record.raise_on_association_not_found = true
end

重启测试后，传入无效关联名就会直接抛出异常，和控制台行为一致。

2. 单测试内手动校验关联合法性 #

如果不想全局修改配置，在用到includes的测试里先校验关联名是否有效：

# 获取当前模型所有合法的关联名
valid_assocs = User.reflect_on_all_associations.map(&:name)
invalid_assoc = "random_string"

# 先断言关联名有效，无效则直接报错
expect(valid_assocs).to include(invalid_assoc.to_sym), "关联名 #{invalid_assoc} 不存在"

# 再执行includes操作
user = User.includes(invalid_assoc.to_sym).first

3. 检查是否有Mock干扰 #

如果测试中用了Rspec的mock/stub模拟不存在的关联方法，比如：

allow_any_instance_of(User).to receive(:random_string).and_return([])

这类Mock会让关联返回空集合而不触发原生异常，移除后就能恢复正常报错逻辑。

补充说明 #

正常情况下，includes遇到无效关联名应该在解析阶段就报错，测试环境的默认行为是为了兼容部分旧测试场景，但开启严格校验能帮你更早发现代码错误，提升测试可靠性。

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