挂载引擎引入主应用Helper，Capybara+RSpec测试报错求解决

这个问题我之前帮朋友排查过，核心原因是测试环境下，引擎的测试上下文并没有自动继承主应用Helper的加载逻辑——哪怕你在Admin::ApplicationController里写了helper ::ApplicationHelper，测试时的helper对象可能还是没包含这个模块，导致调用foo时报错。给你几个靠谱的解决办法：

方法1：在RSpec配置中主动注入主应用Helper #

在引擎的测试配置文件（比如spec/spec_helper.rb或者spec/rails_helper.rb）里，添加RSpec的钩子，在测试运行前给对应的测试类型注入ApplicationHelper：

RSpec.configure do |config|
  # 针对Capybara系统测试（system test）
  config.before(:each, type: :system) do
    # 给测试中的helper对象添加ApplicationHelper模块
    helper.class.send(:include, ::ApplicationHelper)
  end

  # 如果还有控制器测试需要用到，也加上对应的钩子
  config.before(:each, type: :controller) do
    @controller.class.send(:include, ::ApplicationHelper)
  end
end

这个方法的好处是精准针对测试场景，不会影响开发/生产环境的代码逻辑。

方法2：修改引擎控制器的Helper引入方式 #

有时候单纯用helper ::ApplicationHelper在测试环境可能因为加载顺序问题不生效，可以尝试在控制器中直接include这个模块：

# app/controllers/admin/application_controller.rb
module Admin
  class ApplicationController < ::ApplicationController
    # 保留原来的helper声明，同时主动include模块
    helper ::ApplicationHelper
    include ::ApplicationHelper
  end
end

这样能确保控制器本身以及它的测试上下文都能访问到主应用的Helper方法。

方法3：检查测试类的继承关系 #

如果你的Capybara测试是自定义的系统测试类，要确保它正确继承了引擎的基础测试类，并且没有覆盖helper的设置。比如：

# spec/system/admin/base_system_test_case.rb
module Admin
  class BaseSystemTestCase < ActionDispatch::SystemTestCase
    driven_by :selenium, using: :chrome, screen_size: [1400, 1400]

    # 在这里也可以主动引入ApplicationHelper
    include ::ApplicationHelper
  end
end

然后你的具体测试类继承这个Admin::BaseSystemTestCase，就能确保Helper方法可用。

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