Rails 7升级后Zeitwerk无法自动加载模型的问题求助

问题根源分析 #

你遇到的核心问题是错误干预了Zeitwerk的默认自动加载配置：

• Rails 7默认使用Zeitwerk作为自动加载器，app/models是它自动管理的标准目录，不需要手动添加到autoload_once_paths，这会触发重复加载警告。
• 后续通过ignore("app/models")排除模型目录，直接导致模型无法被自动加载，虽然临时解决了重复加载警告，但引发了测试环境的常量未定义错误。

修复步骤 #

1. 移除错误配置

   • 从application.rb中删除这一行：

     config.autoload_once_paths << "app/models"
     

   • 删除config/initializers/zeitwerk.rb中的Rails.autoloaders.main.ignore("app/models")配置（如果文件仅包含这一行，可以直接删除整个文件）。

2. 验证模型文件命名规范
   Zeitwerk对文件名和类名的对应关系要求严格：

   • 类User必须对应文件app/models/user.rb（全小写文件名）
   • 命名空间类（如Admin::User）必须对应文件app/models/admin/user.rb
   • 确保文件名没有拼写错误、大小写错误，或使用不符合约定的命名（比如UserModel.rb这种非全小写的文件名）

3. 修改后的application.rb代码

   class Application < Rails::Application
     config.load_defaults 7.0
     config.active_record.pluralize_table_names = false
     config.assets.enabled = false
     config.api_only = true
     config.version = Dir.pwd.split('/').last
     config.action_dispatch.ip_spoofing_check = false
   end
   

额外排查点 #

如果修复后仍有问题，可以执行以下命令检查Zeitwerk的加载状态：

bin/rails zeitwerk:check

该命令会自动检测命名规范问题，并给出具体的错误提示，帮助你定位剩余问题。

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