Rails 5升级至Rails 7后出现NameError未初始化常量问题求助

问题详情 #

• 升级场景：旧Ruby应用从Rails 5升级到Rails 7
• 触发时机：rails s启动应用成功，但访问浏览器时触发错误
• 相关文件：app/models/faculty_w/v1/appointment.rb，代码如下：

class FacultyW::V1::Appointment
  include ActiveModel::Validations
  include AppointmentCommon
  include Swagger::Blocks
  include SwaggerSchemas
end

• 错误信息：

NameError (uninitialized constant FacultyW::V1::Appointment::SwaggerSchemas):

app/models/faculty_w/v1/appointment.rb:5:in `<class:Appointment>'
app/models/faculty_w/v1/appointment.rb:1:in `<top (required)>'

app/controllers/apidocs_controller.rb:47:in `<class:ApidocsController>'
app/controllers/apidocs_controller.rb:1:in `<top (required)>'

已尝试的无效操作 #

• 运行zeitwerk:check，无修复建议
• 在application.rb中添加路径配置：

  config.eager_load_paths += %W(#{config.root}/app/models/faculty_w/v1)
  config.autoload_paths += %W(#{config.root}/app/models/faculty_w/v1)
  

• 设置config.autoloader = :classic

解决方案 #

1. 匹配Zeitwerk的文件命名与路径规则 #

Zeitwerk要求常量名与文件名严格对应：

• 若SwaggerSchemas是顶级模块，对应的文件必须是app/models/swagger_schemas.rb（或其他已在autoload路径下的对应位置）
• 若它是FacultyW::V1命名空间下的模块，文件路径必须为app/models/faculty_w/v1/swagger_schemas.rb

2. 显式引用顶级常量 #

如果SwaggerSchemas是顶级模块，可在Appointment类中添加双冒号强制引用顶级命名空间：

class FacultyW::V1::Appointment
  include ActiveModel::Validations
  include AppointmentCommon
  include Swagger::Blocks
  include ::SwaggerSchemas # 显式指定顶级模块
end

3. 手动引入文件 #

若自动加载未触发，可在appointment.rb顶部手动引入文件：

require Rails.root.join('app/models/swagger_schemas') # 根据实际路径调整

class FacultyW::V1::Appointment
  # ... 原有代码
end

4. 清理多余的路径配置 #

app/models本身就在Rails默认的autoload路径中，子目录会被Zeitwerk自动扫描。移除手动添加的eager_load_paths和autoload_paths配置，重新运行：

rails zeitwerk:check

若存在命名或路径不匹配，Zeitwerk会给出具体提示。

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