如何用RSpec测试reCAPTCHA验证失败的分支场景？

问题出在你只mock了verify_recaptcha返回false，但没有模拟该方法真实的行为——给resource对象添加验证错误。reCAPTCHA gem的verify_recaptcha在验证失败时，会自动把错误信息追加到指定模型的errors集合中，而你的mock缺少这一步，导致控制器中respond_with_navigational的逻辑没有正确触发，分支代码未被覆盖。

修正后的测试方案 #

直接在mock中模拟错误添加的行为，同时保持和控制器逻辑一致的resource初始化流程：

RSpec.describe SessionsController, type: :controller do
  describe 'POST #create' do
    context '验证码验证失败时' do
      let(:sign_in_params) { { email: 'test@example.com', password: '123456' } }

      before do
        # 精准mock当前控制器的verify_recaptcha方法
        allow(controller).to receive(:verify_recaptcha) do
          # 按照控制器逻辑初始化resource
          controller.resource = User.new(sign_in_params)
          # 添加reCAPTCHA验证失败的错误（和gem默认行为一致）
          controller.resource.errors.add(:base, I18n.t('recaptcha.errors.verification_failed'))
          # 返回验证失败的结果
          false
        end

        # 发送登录请求
        post :create, params: { user: sign_in_params }
      end

      it '渲染登录页面' do
        expect(response).to render_template(:new)
      end

      it '用登录参数初始化resource对象' do
        expect(assigns(:resource)).to have_attributes(email: sign_in_params[:email])
      end

      it '清空recaptcha_error的flash消息' do
        expect(flash[:recaptcha_error]).to be_nil
      end
    end
  end
end

关键说明 #

1. 避免使用allow_any_instance_of：优先mock当前测试的控制器实例（controller对象），减少对其他测试用例的干扰。
2. 模拟真实行为：严格复刻reCAPTCHA gem的错误添加逻辑，确保控制器中的代码分支能完整触发——包括self.resource = resource_class.new sign_in_params和respond_with_navigational块内的逻辑。
3. 匹配错误信息：使用gem默认的国际化错误信息（I18n.t('recaptcha.errors.verification_failed')），保证和生产环境逻辑一致。

如果你的测试环境全局跳过了reCAPTCHA（比如设置了Recaptcha.skip_verify_env = ['test']），无需额外修改——mock的方法会覆盖全局跳过的设置，确保测试能触发失败分支。

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