如何在RSpec中隔离测试Rails helper 避免测试变量/方法影响

问题复现 #

在添加了rspec-rails依赖的Rails项目中，存在如下带缺陷的helper代码：

# app/helpers/my_helper.rb
module MyHelper
  def helper_method(_variable)
    # 笔误：形参是_variable，却访问了不存在的variable
    variable.to_s
  end
end

如果写如下测试用例，运行时不会报错，会错误通过：

require "rails_helper"

RSpec.describe MyHelper do
  let(:variable) { :test }

  it "succeeds" do
    # 裸调用helper方法
    expect(helper_method(variable)).to eq "test"
  end
end

这段代码在真实Rails运行环境中本应抛出NameError，但测试环境中因为helper能直接访问测试上下文里let(:variable)定义的方法，导致bug被掩盖。
可以用如下脚本在Rails 7.0.3版本复现问题：

rails new helper-test
cd helper-test
bundle add rspec-rails
bundle

bin/rails g rspec:install
mkdir spec/helpers

cat > app/helpers/my_helper.rb <<EOF
module MyHelper
  def helper_method(_variable)
    variable.to_s
  end
end
EOF

cat > spec/helpers/my_helper_spec.rb <<EOF
require "rails_helper"

RSpec.describe MyHelper do
  let(:variable) { :test }

  it "succeeds" do
    expect(helper_method(variable)).to eq "test"
  end
end
EOF

bin/rails spec

问题原因 #

出现这个现象的核心原因是rspec-rails的helper spec默认行为：框架会自动把被测helper模块include进测试用例的上下文类中，允许开发者直接裸调用helper方法。
这种情况下：

• 裸调用helper方法时，方法内的self指向测试用例实例
• 所有通过let定义的变量本质都是测试实例上的方法，会被Ruby的方法查找链命中
• 所以helper里笔误写的variable不会触发未定义变量错误，反而拿到了测试里定义的let值
  而在真实生产环境中，helper方法的执行上下文是独立的ActionView::Base渲染实例，上面不存在任何测试上下文里定义的方法，代码会按预期抛出错误。

原生解决方案 #

不需要手动编写独立隔离类，rspec-rails本身就提供了完全隔离的测试代理对象，就是测试中可直接访问的helper对象。
这个对象是独立初始化的ActionView::Base实例，仅extend了当前被测的helper模块，和测试上下文的let定义、测试类方法完全隔离。只要所有helper方法都显式通过helper.方法名的形式调用，就能完全复现真实运行环境的方法查找逻辑，准确捕获bug。
改成如下写法的测试会按预期失败：

require "rails_helper"

RSpec.describe MyHelper do
  let(:variable) { :test }

  it "succeeds" do
    # 显式通过隔离的helper代理调用方法
    expect(helper.helper_method(variable)).to eq "test"
  end
end

手动写隔离测试类、extend helper模块的实现，本质和框架提供的helper代理逻辑完全一致，属于重复造轮子。

最佳实践 #

目前rspec-rails没有提供配置项可以彻底关闭helper自动include进测试上下文的行为，只需要遵守一个简单约定就能彻底避免这类假通过问题：
所有helper方法调用必须显式发送给helper代理对象，绝对不要在测试中裸调用helper方法。
裸调用是rspec-rails早期版本遗留的便捷语法，本身就存在上下文污染的风险，不符合测试隔离的原则，不建议使用。

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