Ruby2.7.5+Rails6.1.5升级后出现未初始化常量NameError求助

核心原因 #

Rails 6.x 默认使用 Zeitwerk 自动加载器，相比 Rails 5.x 的经典自动加载器，它对文件名与模块名的匹配规则要求更严格；同时你的 helper 文件命名不符合自动加载约定，导致无法正确解析对应模块。

解决方案1：修正文件名（推荐） #

将文件 web/shared/_commercial_beyond_banner_helper.rb 重命名为 web/shared/commercial_beyond_banner_helper.rb，去掉文件名开头的下划线。

Zeitwerk 会将下划线开头的文件视为“私有”文件，不会自动加载对应的模块；而正常命名的文件会遵循“蛇形文件名对应驼峰模块名”的规则，正确匹配 Web::Shared::CommercialBeyondBannerHelper 模块。

解决方案2：调整自动加载路径配置 #

如果无法修改文件名，需要在 config/application.rb 中添加目录到自动加载路径，同时确保 Zeitwerk 能识别该文件：

# config/application.rb
module YourAppName
  class Application < Rails::Application
    # 确保 web 目录被纳入自动加载范围
    config.autoload_paths << Rails.root.join('web')
    config.eager_load_paths << Rails.root.join('web')
  end
end

修改后重启 Rails 服务，让配置生效。

解决方案3：手动加载模块（临时方案） #

在需要使用该 helper 的文件顶部，手动加载对应的模块文件：

require Rails.root.join('web/shared/_commercial_beyond_banner_helper')

此方法仅作为临时 workaround，不推荐长期使用，会破坏自动加载的一致性。

内容的提问来源于stack exchange，提问作者Khôi Nguyễn Đình