Rspec expect to change匹配器计数异常问题排查

核心是after_commit回调和RSpec默认事务测试机制的冲突：

• RSpec搭配Rails使用时默认开启事务性测试：每个测试用例的所有数据库操作都会被包裹在一个外层事务中，测试结束后直接回滚，避免测试数据残留。
• 你在SubscriptionItem模型上绑定的是after_commit :create_customer_quotas, on: :create回调，这类回调的触发前提是记录对应的数据库事务真正完成提交。
• 默认事务测试模式下，执行subscription.save!时，虽然关联的SubscriptionItem记录会写入数据库，但整个操作始终处于测试的外层未提交事务中，after_commit回调根本不会被触发。
• RSpec的change匹配器执行逻辑为：先查询一次目标值作为初始基准 -> 执行传入块内的代码 -> 再查询一次目标值作为最终结果 -> 对比差值。由于回调未执行，两次查询CustomerQuota.count的差值为0，就会抛出你看到的报错。

你手动拆分前后计数能得到before=0 && after=1的正确结果，本质是两种场景的执行环境不一致：

• 要么你运行手动计数代码的测试用例关闭了事务性测试，或是配置DatabaseCleaner时用了截断/删除策略而非事务策略，此时save!会真正提交事务，触发after_commit回调创建对应记录。
• 要么手动计数的代码中，save!之后存在其他操作（比如关联对象reload、额外的数据库写入）隐式触发了事务提交，让回调正常执行。

根据项目的Rails版本和测试配置选择对应方案即可：

• Rails 5.0及以上版本：直接在测试环境配置中开启原生支持，让事务测试模式下也能正常触发after_commit回调，在config/environments/test.rb中添加：

config.active_record.run_commit_callbacks_on_commit_in_transactional_tests = true

• Rails 5.0以下版本：可以引入对应兼容gem让事务测试支持after_commit回调触发。
• 单测试用例临时修复：在块内save操作后手动触发关联记录的commit回调：

expect {
  subscription.save!
  subscription.subscription_items.each { |item| item.run_callbacks(:commit) }
}.to change(CustomerQuota, :count).by(subscription.quotas.count)

• 调整测试清理策略：对涉及after_commit回调的测试用例，不使用事务清理策略，改用截断策略，让数据库操作真实提交。

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