Rails 5环境下如何在单元测试中模拟Google reCAPTCHA验证

嘿，我来帮你搞定这个Rails 5里Google reCAPTCHA的控制器测试问题！既然你已经用gem集成了reCAPTCHA，核心思路就是完全mock掉和Google的真实交互——测试没必要真的调用第三方API，既慢又不稳定。下面分两种主流测试框架（Minitest和RSpec）给你具体实现步骤，还有常见坑的排查：

一、先明确核心：Mock reCAPTCHA验证逻辑 #

不管用哪种测试框架，我们的目标都是替换掉verify_recaptcha方法的真实行为，自己控制它返回“通过”或“失败”，这样就能测试两种分支场景。

1. Minitest用户看这里 #

全局Mock（一次性搞定所有测试）

如果你希望所有测试默认都跳过reCAPTCHA验证，可以在test/test_helper.rb里加这段代码：

# test/test_helper.rb
class ActionController::TestCase
  def verify_recaptcha(*)
    true # 强制返回验证通过，后续单个测试可以覆盖这个行为
  end
end

单个测试灵活控制（测试通过/失败两种场景）

如果要分别测试验证通过和失败的情况，用Minitest的stub方法单独控制：

# test/controllers/your_form_controller_test.rb
require 'test_helper'

class YourFormControllerTest < ActionDispatch::IntegrationTest
  test "表单提交成功当reCAPTCHA验证通过时" do
    # 临时mock验证方法返回true
    YourFormController.any_instance.stub(:verify_recaptcha, true) do
      post your_form_path, params: {
        your_model: { name: "测试名称", email: "test@example.com" },
        # 注意：哪怕是假的token也要传，gem会检查这个参数是否存在
        'g-recaptcha-response' => 'fake_valid_token'
      }

      # 验证跳转和数据是否创建成功
      assert_response :redirect
      assert YourModel.exists?(name: "测试名称")
    end
  end

  test "表单提交失败当reCAPTCHA验证不通过时" do
    # 临时mock验证方法返回false
    YourFormController.any_instance.stub(:verify_recaptcha, false) do
      post your_form_path, params: {
        your_model: { name: "测试名称", email: "test@example.com" },
        'g-recaptcha-response' => 'fake_invalid_token'
      }

      # 验证停留在表单页，数据没创建
      assert_response :unprocessable_entity
      assert_not YourModel.exists?(name: "测试名称")
      # 还可以检查页面是否有错误提示
      assert_select 'div.alert', 'reCAPTCHA验证失败，请重试'
    end
  end
end

2. RSpec用户看这里 #

用RSpec的allow方法来mock控制器的verify_recaptcha方法：

# spec/controllers/your_form_controller_spec.rb
RSpec.describe YourFormController, type: :controller do
  describe "POST #create" do
    context "reCAPTCHA验证通过" do
      before do
        # mock验证通过
        allow(controller).to receive(:verify_recaptcha).and_return(true)
      end

      it "成功创建记录并跳转" do
        post :create, params: {
          your_model: { name: "测试名称", email: "test@example.com" },
          'g-recaptcha-response' => 'fake_token'
        }

        expect(YourModel.count).to eq(1)
        expect(response).to redirect_to(your_model_path(YourModel.last))
      end
    end

    context "reCAPTCHA验证失败" do
      before do
        # mock验证失败
        allow(controller).to receive(:verify_recaptcha).and_return(false)
      end

      it "不创建记录，停留在表单页" do
        post :create, params: {
          your_model: { name: "测试名称", email: "test@example.com" },
          'g-recaptcha-response' => 'invalid_token'
        }

        expect(YourModel.count).to eq(0)
        expect(response).to have_http_status(:unprocessable_entity)
        expect(flash[:alert]).to eq('reCAPTCHA验证失败，请重试')
      end
    end
  end
end

二、你之前测试失败的常见原因排查 #

1. 没有mock验证逻辑：测试时真的调用了Google的API，返回验证失败（毕竟你传的是假token）
2. 没传g-recaptcha-response参数：哪怕是假的，gem也会检查这个参数是否存在，否则直接判定失败
3. 控制器逻辑有问题：比如verify_recaptcha的返回值没和保存逻辑绑定，比如控制器里应该这么写：

# app/controllers/your_form_controller.rb
def create
  @your_model = YourModel.new(your_model_params)
  # 一定要把reCAPTCHA验证和保存逻辑结合起来
  if verify_recaptcha(model: @your_model) && @your_model.save
    redirect_to @your_model, notice: '创建成功'
  else
    render :new
  end
end

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