Rails 7应用调用Model时触发'uninitialized constant'错误求助

问题场景 #

• 服务类文件路径：app/services/sales_service.rb，代码：

class SalesService
  def gensalesdata
    print "TESTING: #{AuthorSale.last} \n"
  end
end

• 调用该服务的Rake任务：

task :testtask1 do
  SalesService.new.gensalesdata
end

• 被调用的Model类路径：app/models/author_sale.rb，代码：

class AuthorSale < ApplicationRecord
end

执行Rake任务或通过Web服务器运行时，报错：

uninitialized constant SalesService::AuthorSale

但在Rails控制台中执行相同代码可正常运行。

已完成的排查步骤 #

• 执行bin/rails zeitwerk:check，返回"Hold on, I am eager loading the application. All is good!"
• 在config/environments/development.rb中设置config.eager_load = true
• 验证MySQL表名为author_sales，符合Rails命名规范
• 排查发现：在服务类中打印ActiveSupport::Dependencies.autoload_paths结果为空数组，且config/environments/development.rb中的代码未执行

问题根源 #

核心原因是运行服务类的上下文未加载完整的Rails环境：

1. 默认Rake任务如果没有依赖:environment，不会初始化Rails的自动加载机制，导致autoload_paths为空，无法找到app/models下的类
2. Web服务器若未通过Rails官方启动脚本运行，也可能跳过环境初始化流程
3. Rails控制台默认会加载完整环境，因此能正常解析Model类

解决方法 #

1. 修改Rake任务，强制加载Rails环境 #

将Rake任务修改为依赖:environment，确保执行任务前先初始化Rails环境：

task :testtask1 => :environment do
  SalesService.new.gensalesdata
end

如果是自定义的独立Rake文件（不在lib/tasks目录下），需手动加载环境配置：

require_relative '../config/environment'

task :testtask1 do
  SalesService.new.gensalesdata
end

2. 检查Web服务器启动方式 #

确保使用Rails官方启动命令启动服务器：

bin/rails server

避免直接通过Ruby脚本启动服务，否则可能跳过环境初始化步骤。

3. 验证自动加载路径配置 #

检查config/application.rb中是否存在修改autoload_paths的代码，若有需确保保留默认的app/models路径：

# 错误示例：覆盖了默认路径
# config.autoload_paths = %W(#{config.root}/lib)

# 正确示例：添加自定义路径而非覆盖
config.autoload_paths << "#{config.root}/lib"

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