升级Rails 5.2至6.0后出现未初始化常量错误求助

问题原因 #

Rails 6.0默认启用Zeitwerk自动加载器，与旧版经典加载器的常量查找逻辑不同：在嵌套命名空间（如Sites::NetworkResolver）中直接引用ExternalApi时，Zeitwerk会优先在当前命名空间下查找Sites::NetworkResolver::ExternalApi，而非直接定位顶层的ExternalApi模块，从而导致未初始化错误。

解决方案 #

方案一：使用绝对常量引用（推荐，修改量小） #

在所有引用ExternalApi的代码前添加::，明确指定为顶层模块，无需修改服务层代码：

module Sites
  class NetworkResolver
    ::ExternalApi::Graphql
    ...
  end
end

可通过编辑器全局替换功能批量处理所有引用位置，快速完成修改。

方案二：调整Zeitwerk自动加载配置 #

在config/application.rb中添加Zeitwerk配置，确保顶层ExternalApi模块及其子模块被正确识别：

# config/application.rb
class Application < Rails::Application
  config.load_defaults 6.0

  config.after_initialize do
    # 确保蛇形文件名与驼峰常量名匹配（Zeitwerk默认已支持，此步为兜底）
    Rails.autoloaders.main.inflector.inflect(
      "external_api" => "ExternalApi"
    )
  end
end

若仍存在加载问题，可在app/services/external_api.rb中显式加载子模块（不推荐，会破坏自动加载特性）：

# app/services/external_api.rb
module ExternalApi
  require_relative "external_api/graphql"
  ...
end

验证修复 #

执行以下命令确认自动加载配置无错误：

rails zeitwerk:check

内容的提问来源于stack exchange，提问作者Gleydson S. Tavares