Rails 7引擎自动加载控制器方法报NameError问题求助

问题原因 #

Rails7默认使用Zeitwerk作为自动加载器，替代了旧版的经典自动加载机制，对文件路径、命名空间的对应关系和加载时机有更严格的要求。你的报错是因为自动加载器未能找到PushType::ApplicationControllerMethods模块，手动添加autoload_paths的方式已不再适配Zeitwerk的规则。

解决方案 #

1. 移除手动配置的autoload_paths #

Zeitwerk会自动识别Rails引擎的标准目录（包括app/controllers/concerns），无需手动添加路径。删除engine.rb中以下代码：

config.autoload_paths << File.expand_path("../../../app/controllers/concerns", __FILE__) <<
                         File.expand_path("../../../app/helpers", __FILE__)

2. 确保模块与文件路径严格对应 #

检查application_controller_methods.rb的模块定义，必须和文件路径完全匹配：
文件路径：root/core/app/controllers/concerns/push_type/application_controller_methods.rb
模块代码应为：

module PushType
  module ApplicationControllerMethods
    # 你的concern代码
  end
end

3. 调整初始化逻辑，确保模块加载时机正确 #

修改push_type.application_controller初始化器，通过require_dependency强制加载模块（避免Zeitwerk按需加载的时机问题）：

initializer 'push_type.application_controller' do
  ActiveSupport.on_load :action_controller do
    # 手动加载依赖，确保模块在include前已被加载
    require_dependency "#{PushType::Core::Engine.root}/app/controllers/concerns/push_type/application_controller_methods"
    include PushType::ApplicationControllerMethods
  end
end

4. 移除可能冲突的预加载逻辑 #

注释掉config.to_prepare中的eager_load!调用，避免开发环境下自动加载机制冲突：

# config.to_prepare do
#   Rails.application.eager_load! unless Rails.application.config.cache_classes
# end

验证 #

重启Rails服务器后，自动加载机制会正确识别并加载PushType::ApplicationControllerMethods模块，报错即可解决。

内容的提问来源于stack exchange，提问作者Michael K Madison