如何不借助额外Gem编写Rspec测试触发Faraday异常捕获分支？

我来帮你搞定这个测试问题！不用WebMock这类额外Gem，完全可以靠RSpec自带的Stub功能触发start方法里的异常捕获分支，核心思路就是模拟抛出你要测试的Faraday异常，让代码直接进入rescue块。

核心实现思路 #

你需要找到start方法里实际发起网络请求的那个调用点（可能是直接调用Faraday.get，也可能是你封装的某个请求方法），然后用RSpec的Stub功能让这个调用直接抛出指定的Faraday异常，这样就能触发rescue分支了。

具体测试代码示例 #

假设你的start方法里是直接调用Faraday发起请求，比如：

def start
  Faraday.get('https://example.com/api')
  # 其他业务代码
rescue Faraday::ConnectionFailed, Faraday::TimeoutError, Faraday::SSLError => e
  message 'CONNECTION FAILED'
end

对应的RSpec测试可以这么写：

RSpec.describe YourClassName do
  describe '#start' do
    context 'when Faraday network errors occur' do
      it 'triggers CONNECTION FAILED message on connection failure' do
        # Stub Faraday.get方法，让它直接抛出ConnectionFailed异常
        allow(Faraday).to receive(:get).and_raise(Faraday::ConnectionFailed)
        
        # 断言message方法会被传入指定参数调用
        expect(subject).to receive(:message).with('CONNECTION FAILED')
        
        # 执行start方法
        subject.start
      end

      it 'triggers CONNECTION FAILED message on timeout' do
        allow(Faraday).to receive(:get).and_raise(Faraday::TimeoutError)
        
        expect(subject).to receive(:message).with('CONNECTION FAILED')
        
        subject.start
      end

      it 'triggers CONNECTION FAILED message on SSL error' do
        allow(Faraday).to receive(:get).and_raise(Faraday::SSLError)
        
        expect(subject).to receive(:message).with('CONNECTION FAILED')
        
        subject.start
      end
    end
  end
end

如果是封装了自定义请求方法的情况 #

如果你的start里调用的是自己封装的请求方法（比如client.get，其中client是Faraday实例），那只需要调整Stub的目标：

RSpec.describe YourClassName do
  let(:faraday_client) { double('Faraday::Connection') }

  before do
    # 先Stub获取client的方法，返回我们的模拟对象
    allow(subject).to receive(:client).and_return(faraday_client)
  end

  describe '#start' do
    it 'handles Faraday connection errors' do
      # 让模拟的client.get方法抛出异常
      allow(faraday_client).to receive(:get).and_raise(Faraday::ConnectionFailed)
      
      expect(subject).to receive(:message).with('CONNECTION FAILED')
      
      subject.start
    end
  end
end

关键要点 #

• 不需要任何额外Gem，完全靠RSpec自带的Stub/Mock功能就能模拟异常场景；
• 核心是精准Stub掉start方法中发起网络请求的那个调用，让它直接抛出你要测试的异常，从而触发rescue分支；
• 可以分别测试每个异常类型，也可以合并成一个测试用例（用or组合异常类型），看你的测试粒度需求。

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