升级Rails6.1后RSpec测试中controller.controller_name为nil

问题原因 #

Rails 6.1 调整了 Action View 测试用例的底层初始化逻辑，Helper 测试运行时不再默认生成名为test的虚拟controller，因此直接访问controller.controller_name时会返回nil，触发NoMethodError。Rails 6.0 中默认返回"test"属于框架测试模块的内部隐式实现，不属于公开承诺的稳定行为，版本迭代时发生变动属于预期内的调整。

处理方式 #

该场景下需要显式设置controller相关参数，不要依赖旧版本的隐式默认值，有两种常用实现方案：

• 如果Helper是绑定特定Controller使用的，直接在测试中显式声明对应的Controller类，框架会自动完成controller实例的正确初始化：

# spec/helpers/my_helper_spec.rb
describe MyHelper do
  # 替换为该Helper实际挂载的Controller类名
  tests YourTargetController

  it "foo" do
    expect(foobar).to eq(:test)
  end
end

• 如果是跨Controller使用的通用Helper，直接在测试用例中stubcontroller_name的返回值，模拟对应测试场景即可：

# spec/helpers/my_helper_spec.rb
describe MyHelper do
  it "foo" do
    allow(controller).to receive(:controller_name).and_return("test")
    expect(foobar).to eq(:test)
  end
end

注意：所有Helper测试中涉及访问Controller属性的场景，都建议显式声明依赖或者Mock对应返回值，不要依赖框架的隐式默认值，避免后续版本升级出现非预期报错。

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