Zeitwerk + Rails 6.1命名空间子类未预加载，subclasses无返回

问题本质 #

这不是目录结构或命名写法的问题，你的类文件存放路径和命名完全符合Rails约定：

• 父类QueuedEmail对应app/models/queued_email.rb
• 命名空间子类QueuedEmail::CommentNotification对应app/models/queued_email/comment_notification.rb
• 两种子类写法（直接用class QueuedEmail::CommentNotification或嵌套模块定义）都是合法的，Zeitwerk能正确识别

核心原因是Zeitwerk的懒加载特性：Rails不会在启动时自动加载所有模型文件，只有当代码首次引用某个类时，才会加载对应的文件。而subclasses方法只返回当前已经加载到Ruby虚拟机中的子类，所以在你显式访问QueuedEmail::CommentNotification之前，它并没有被加载，自然不会出现在subclasses的结果里。

解决办法 #

如果需要在启动时就把所有子类预加载到内存，让subclasses返回完整列表，可选择以下方式：

1. 手动触发子类加载
   在父类文件末尾添加代码，批量加载所有命名空间子类：

# app/models/queued_email.rb
class QueuedEmail < ApplicationRecord
  # ... 你的业务代码
end

# 遍历并加载queued_email目录下的所有子类文件
Dir[Rails.root.join("app/models/queued_email/*.rb")].each do |file|
  filename = File.basename(file, ".rb")
  "QueuedEmail::#{filename.camelize}".constantize
end

2. 开启eager_load机制
   在环境配置文件中开启eager_load（生产环境默认开启，开发环境默认关闭）：

# config/environments/development.rb
Rails.application.configure do
  config.eager_load = true
end

注意：开发环境开启eager_load后，每次代码变更都需要重启服务器，会影响开发效率，建议仅在需要预加载的场景临时开启，或只在生产环境依赖该特性。

3. require_dependency（不推荐）
   在父类文件中手动加载每个子类，这种方式需要逐个维护，子类增多时不够灵活：

# app/models/queued_email.rb
class QueuedEmail < ApplicationRecord
  # ...
end

require_dependency "queued_email/comment_notification"
# 其他子类依次添加

配置正确性验证 #

从Zeitwerk的日志可以确认你的命名空间配置完全正确：

Zeitwerk@rails.main: autoload set for QueuedEmail, to be autovivified from /vagrant/rails_app/app/models/queued_email
Zeitwerk@rails.main: earlier autoload for QueuedEmail discarded, it is actually an explicit namespace defined in /vagrant/rails_app/app/models/queued_email.rb
Zeitwerk@rails.main: autoload set for QueuedEmail, to be loaded from /vagrant/rails_app/app/models/queued_email.rb

日志说明Zeitwerk正确识别了QueuedEmail是一个类（而非自动生成的模块），且会从正确路径加载，子类的自动加载路径也会被正常识别。

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