升级至Rails 7后Product模型Enum重复加载问题求助

问题重现 #

Product模型代码如下（遗留代码，忽略命名和类型问题）：

class Product < ApplicationRecord

  FIREARM_NAMES = %w{ Frame Pistol Receiver Revolver Rifle Shotgun }
  PAGINATE_BY   = 24

  enum map_price_source: [:map_source_is_distributor, :map_source_is_brand]

  # ... 其他代码
end

在Rails控制台调用Product或Product.last时，抛出以下错误：

ArgumentError: You tried to define an enum named "map_price_source" on the model "Product", but this will generate a instance method "map_source_is_distributor?", which is already defined by another enum.

同时出现常量重复初始化警告：

.../app/models/product.rb:3: warning: already initialized constant Product::FIREARM_NAMES
.../app/models/product.rb:3: warning: previous definition of FIREARM_NAMES was here
.../app/models/product.rb:4: warning: already initialized constant Product::PAGINATE_BY
.../app/models/product.rb:4: warning: previous definition of PAGINATE_BY was here

可能原因 #

• 模型文件被重复加载：项目中存在手动require 'product'的代码（比如初始化脚本、lib文件或其他模型），与Rails自动加载机制重复加载了Product类
• 命名空间冲突：项目内其他位置（如lib目录、引擎）定义了同名的Product类，导致常量被重载
• Zeitwerk自动加载机制适配问题：Rails 7默认使用Zeitwerk自动加载器，若文件命名不符合约定（比如文件名与类名不匹配），或修改了config.autoload_paths等配置，可能触发重复加载
• 开发环境缓存残留：旧的类定义缓存未清理，导致重新加载时出现冲突

解决方案 #

1. 排查并移除手动require

   • 全局搜索项目代码，查找require 'product'、require_relative '../app/models/product'这类手动加载代码，删除多余的调用

2. 检查命名空间冲突

   • 搜索所有包含class Product的文件，确保只有app/models/product.rb一处定义；若存在其他同名类，需重命名或调整命名空间

3. 适配Zeitwerk自动加载约定

   • 确认模型文件名为product.rb（小写单数），与类名Product严格对应
   • 检查config/initializers下的配置，避免修改config.autoload_paths导致自动加载路径混乱；若有自定义路径需求，使用config.autoload_paths << Rails.root.join('lib')并确保文件结构符合命名约定

4. 清理缓存并重启

   • 运行命令清理临时文件和缓存：

     rails tmp:clear
     

   • 完全退出Rails控制台后重新启动，避免reload!触发二次加载冲突

5. 定位加载来源（调试用）

   • 在product.rb开头添加调试代码：

     puts "Loading Product class from: #{__FILE__}"
     

   • 启动控制台，观察输出次数和文件路径，确定重复加载的来源

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