Rails 7升级后调用lib代码报NameError (uninitialized constant Error)

核心原因 #

Rails 7 默认使用 Zeitwerk 作为自动加载器，它对文件路径与常量命名的对应关系有严格要求，这和旧版Rails使用的经典自动加载器规则差异很大，这是你遇到NameError (uninitialized constant Error)的主要原因。

解决步骤 #

1. 校验文件内的常量定义 #

确保lib/error/test_errors.rb内的代码严格遵循命名空间对应规则，代码结构应该是：

module Error
  class TestErrors
    # 你的业务代码
  end
end

Zeitwerk的核心规则：

• 蛇形命名的目录error对应驼峰命名的模块Error
• 蛇形命名的文件test_errors.rb对应驼峰命名的类TestErrors

2. 将lib目录纳入Zeitwerk加载路径 #

在config/application.rb中添加配置，让Zeitwerk扫描lib目录：

# 方式一：添加到自动加载和预加载路径
config.autoload_paths << Rails.root.join('lib')
config.eager_load_paths << Rails.root.join('lib')

# 方式二：直接推送到Zeitwerk主加载器（更符合Zeitwerk推荐用法）
Rails.autoloaders.main.push_dir(Rails.root.join('lib'))

如果只需要加载lib/error子目录，可改为：

Rails.autoloaders.main.push_dir(Rails.root.join('lib', 'error'))

3. 确保生产环境预加载开启 #

在config/environments/production.rb中确认预加载配置（默认已开启）：

config.eager_load = true

Zeitwerk在生产环境依赖预加载加载所有常量，关闭会导致常量找不到。

4. 重启服务 #

修改配置后必须重启Rails服务器或控制台，Zeitwerk不会动态加载新增的路径配置。

额外排查点 #

• 检查目录/文件名大小写：确保error目录为小写，test_errors.rb为蛇形命名，与常量的驼峰命名严格对应
• 确认旧分支自动加载器：如果旧分支使用经典模式（config.autoloader = :classic），可临时切换验证，但建议适配Zeitwerk规则而非长期依赖旧模式

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