Rails 6生产环境下Controller Concern常量无法被Model Concern加载

生产环境启用Eager Loading，Zeitwerk会一次性加载所有文件，而开发/测试环境采用懒加载模式。由于控制器 concern 和模型 concern 分属不同目录，Zeitwerk的加载顺序可能导致模型 concern 先被加载，此时Example::CONSTANT所在的控制器 concern 还未完成加载，进而触发常量未初始化的错误。

1. 显式声明依赖加载 #

在模型 concern 文件开头添加require_dependency，强制Zeitwerk优先加载控制器 concern：

# app/models/concerns/model/exampleable.rb
require_dependency 'example'

module Model::Exampleable
  extend ActiveSupport::Concern

  included do
    enum status: Example::CONSTANT
  end
end

2. 迁移常量至通用目录 #

将CONSTANT移到不依赖控制器/模型目录的通用位置，比如app/constants/下，消除跨目录加载依赖：

# app/constants/example_constants.rb
module ExampleConstants
  CONSTANT = { active: 0, inactive: 1 } # 替换为实际常量值
end

之后在控制器 concern 和模型 concern 中分别引用：

# app/controllers/concerns/example.rb
module Example
  include ExampleConstants
end

# app/models/concerns/model/exampleable.rb
module Model::Exampleable
  extend ActiveSupport::Concern

  included do
    enum status: ExampleConstants::CONSTANT
  end
end

3. 对齐命名空间与目录结构 #

Zeitwerk严格遵循“命名空间对应目录结构”规则，可调整控制器 concern 的命名空间，让加载逻辑更清晰可控：

# app/controllers/concerns/controller/example.rb
module Controller::Example
  CONSTANT = { ... } # 原常量值
end

在模型 concern 中修改引用路径：

enum status: Controller::Example::CONSTANT

同时确保app/controllers/concerns/controller目录已被纳入eager_load_paths（Rails默认已包含父目录，无需额外配置）。

4. 验证eager_load_paths配置 #

确认application.rb中正确包含相关concerns目录（Rails默认已覆盖，可校验是否存在拼写错误）：

# config/application.rb
config.eager_load_paths += %W[
  #{config.root}/app/controllers/concerns
  #{config.root}/app/models/concerns
]

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