RSpec如何测试if条件分句未执行及测试用例失败问题

待测试的业务代码 #

if @context.persona == :system && @context.scopes&.include?(SEARCH_SCOPE)
  return <something>
end

测试目标：

• 验证当@context.persona不是:system时，@context.scopes&.include?(SEARCH_SCOPE)完全不执行（不会触发scopes方法调用，符合Ruby &&运算符的短路特性）
• 验证当@context.persona是:system时，才会触发scopes方法调用进行作用域判断

当前编写的测试代码 #

context 'when persona is system' do
  let(:persona) { :system }
  
  it 'checks the scope' do
     allow(context).to receive(:scopes)

     expect(context).to have_received(:scopes)
  end
end

context 'when persona is not system' do
  let(:persona) { :user }
  
  it 'checks the scope' do
     allow(context).to receive(:scopes)

     expect(context).not_to have_received(:scopes)
  end
end

报错现象 #

• 第二个「persona不是system」的测试用例可以正常通过
• 第一个「persona是system」的测试用例执行失败，报错信息为：

  Failure/Error: expect(context).to have_received(:scopes)
   
    (Double (anonymous)).scopes(*(any args))
        expected: 1 time with any arguments
        received: 0 times with any arguments
  

问题核心原因 #

测试执行流程缺失关键环节：RSpec的have_received断言仅追踪断言触发前已经实际发生的方法调用。当前测试用例的执行顺序是：给scopes方法打桩 → 直接断言有没有收到调用，全程没有运行过包含短路判断的业务代码，根本不会产生任何方法调用，因此必然报“收到0次调用”的错误。

• allow语句的作用仅为给目标方法注册可追踪的桩，本身不会触发方法执行
• 未触发业务逻辑的前提下，所有针对方法调用的断言都没有实际依据

正确的测试实现方式 #

按照RSpec验证桩方法调用的标准流程调整执行顺序：

1. 给需要追踪的目标方法打可追踪的桩，同时指定合理返回值避免运行时报错
2. 主动触发待测试的业务逻辑
3. 最后执行方法调用的断言

调整后的参考代码：

# 统一定义context测试桩，匹配不同persona场景
let(:context) do
  double('context', persona: persona)
end

context 'when persona is system' do
  let(:persona) { :system }
  
  it 'triggers scopes check' do
    # 给scopes方法打桩，指定返回值避免空值报错
    allow(context).to receive(:scopes).and_return([])

    # 触发待测试的业务逻辑，替换成实际调用的业务方法名即可
    check_access(context)

    # 断言scopes被调用一次
    expect(context).to have_received(:scopes).once
  end
end

context 'when persona is not system' do
  let(:persona) { :user }
  
  it 'does NOT trigger scopes check (short-circuit logic works)' do
    allow(context).to receive(:scopes).and_return([])

    # 触发待测试的业务逻辑
    check_access(context)

    # 断言scopes完全没有被调用
    expect(context).not_to have_received(:scopes)
  end
end

额外说明：由于Ruby中&&运算符存在短路特性，只要左侧判断条件不满足，右侧的表达式完全不会被解析执行，上述测试逻辑可以准确验证这一行为。

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