如何Mock被Recaptcha Gem注入控制器的verify_captcha方法？

问题背景 #

你当前使用 allow_any_instance_of(ApplicationController).to receive(:verify_recaptcha).and_return(true) 来Mock验证码验证，但Rubocop不推荐这种写法——因为它会作用于所有ApplicationController实例，可能引发意外副作用，且测试精准度不足。

推荐替代方案 #

方案1：直接Mock模块的实例方法

由于verify_recaptcha是从Recaptcha::Adapters::ControllerMethods模块注入到控制器的实例方法，你可以直接Mock该模块的实例方法，避免影响整个控制器类：

before do
  allow_any_instance_of(Recaptcha::Adapters::ControllerMethods).to receive(:verify_recaptcha).and_return(true)
end

这种方式比Mock控制器类更精准，仅针对Recaptcha模块注入的方法生效。

方案2：利用Recaptcha内置的测试跳过机制

Recaptcha gem本身提供了测试环境下跳过验证的配置，无需手动Mock。在config/initializers/recaptcha.rb中添加：

Recaptcha.configure do |config|
  # 其他配置...
  config.skip_verify_env << 'test'
end

这样在测试环境中，verify_recaptcha会自动返回true，完全不需要Mock代码。

方案3：针对具体控制器实例精准Mock

在RSpec控制器测试中，你可以仅Mock当前测试用到的控制器实例，进一步提升测试精准度：

it "creates resource when captcha passes" do
  expect(controller).to receive(:verify_recaptcha).and_return(true)
  post :create, params: { ... }
  # 断言逻辑...
end

这种写法只作用于当前测试的控制器实例，不会影响其他测试用例。

方案4：在测试中覆盖控制器方法（局部生效）

如果你需要在某组测试中统一Mock，可以临时覆盖ApplicationController的方法，用RSpec的around钩子控制作用范围：

describe "Captcha-dependent actions" do
  around do |example|
    original_method = ApplicationController.instance_method(:verify_recaptcha)
    ApplicationController.define_method(:verify_recaptcha) { true }
    example.run
    ApplicationController.define_method(:verify_recaptcha, original_method)
  end

  it "passes captcha check" do
    post :create, params: { ... }
    # 断言逻辑...
  end
end

这种方式会在指定测试组内临时替换方法，测试结束后恢复原方法，避免全局污染。

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