Rails中Zeitwerk加载命名空间STI模型报错问题咨询

1. 修正文件与常量的对应关系 #

Zeitwerk遵循严格的路径-常量匹配规则，app/models/foo/bar.rb必须定义Foo::Bar，而非顶级的Bar。你的报错正是路径和常量不匹配导致的，按以下方式修改模型文件：

# app/models/foo/bar.rb
module Foo
  class Bar < ApplicationRecord # 或你的STI父类，比如Foo::Base
    # 如果STI表名不是默认的`foo_bars`（比如原表是`bars`），需手动指定
    self.table_name = "bars"
    # 若数据库`type`字段存的是旧值"Bar"而非"Foo::Bar"，添加此配置让STI识别
    self.sti_name = "Bar"
  end
end

无需创建空的Foo模块文件，Zeitwerk会自动从子目录加载模块定义。

2. 处理STI类型字段兼容 #

如果数据库中type字段存储的是无命名空间的旧值（如"Bar"），除了上述sti_name配置，还可在父模型中添加类型映射，确保STI正确匹配命名空间模型：

# 假设STI父类是ApplicationRecord
class ApplicationRecord < ActiveRecord::Base
  self.abstract_class = true

  def self.sti_class_for(type_name)
    # 映射旧类型名到命名空间模型
    type_name == "Bar" ? Foo::Bar : super
  end
end

3. 匹配Schema目录结构的方案 #

如果想让Schema目录和模型目录结构一致，有两种可选方式：

方案A：Schema与模型同目录 #

将Foo::Bar对应的Schema文件放在app/models/foo/bar_schema.rb，定义Foo::BarSchema，与模型的命名空间、目录结构完全对齐：

# app/models/foo/bar_schema.rb
module Foo
  class BarSchema
    # Schema定义代码
  end
end

方案B：独立Schemas命名空间 #

若要保留app/models/schemas根目录，可在该目录下创建子目录匹配模型命名空间，比如app/models/schemas/foo/bar_schema.rb，定义Schemas::Foo::BarSchema：

# app/models/schemas/foo/bar_schema.rb
module Schemas
  module Foo
    class BarSchema
      # Schema定义代码
    end
  end
end

Rails默认会自动加载app/models下的所有子目录，无需额外配置，Zeitwerk会自动识别schemas作为顶级命名空间。

4. 验证Zeitwerk配置 #

确保config/application.rb中没有修改默认的autoload配置，避免干扰Zeitwerk的命名空间识别：

# config/application.rb
class Application < Rails::Application
  config.load_defaults 7.0
  # 不要添加类似 config.autoload_paths << Rails.root.join('app/models/foo') 的配置，默认已递归加载
end

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