Rails远程部署遇FrozenError：临时关eager_load有效求根因

1. eager_load的加载差异：生产/QA环境config.eager_load=true时，Rails会在启动阶段预加载所有应用代码；开发环境默认false是按需加载。临时方案生效的核心原因是，关闭预加载后代码不会被一次性全部加载，避开了预加载时触发的模块冻结冲突。
2. dry-validations 1.x的特性变化：1.x版本相比0.13.x，会自动冻结定义的Contract/Schema所在的模块，防止运行时被意外修改——这是官方做的性能与安全性优化。但如果你的代码中存在重复打开同一个模块并修改的情况，预加载时第一次加载模块会被dry-validation冻结，第二次加载时尝试修改就会触发FrozenError。
3. 代码加载顺序冲突：预加载时Rails按自动加载规则加载文件，如果Override::CashOverride::Api模块被多个文件重复打开（比如一个文件定义模块，另一个文件在模块内定义Contract），就会触发冻结后的非法修改操作。

1. 清理重复的模块定义 #

• 全局搜索Override::CashOverride::Api，检查是否有多个文件重复执行module Override::CashOverride::Api ... end。
• 确保模块只在一个文件中定义（比如单独创建app/validation_schemas/override/cash_override/api.rb来定义基础模块），其他文件仅在已定义的模块下添加内容，避免重复定义触发多次修改。

2. 调整Contract的定义方式 #

dry-validations 1.x中，避免在易被重复加载的共享模块内直接定义Contract，或者添加冻结检查：

# 不推荐：直接在共享模块内定义Contract，易触发冻结冲突
module Override::CashOverride::Api
  class CreateContract < Dry::Validation::Contract
    # 验证规则
  end
end

# 推荐方案1：单独定义Contract，脱离共享模块
class CashOverrideApiCreateContract < Dry::Validation::Contract
  # 验证规则
end

# 推荐方案2：保留嵌套，但添加冻结检查
module Override::CashOverride::Api
  unless frozen?
    class CreateContract < Dry::Validation::Contract
      # 验证规则
    end
  end
end

3. 修正预加载顺序 #

• 调整文件目录结构，让Rails预加载时先加载模块定义文件，再加载Contract文件。比如：
  • 先创建app/validation_schemas/override/cash_override/api.rb定义模块
  • 再将create_contract.rb放在api子目录下，确保模块先被加载
• 严格遵循Rails自动加载的命名约定，避免因路径/文件名不匹配导致的乱序加载。

4. 本地模拟预加载调试 #

在本地运行以下命令，模拟生产环境的预加载行为，复现问题方便调试：

rails runner "Rails.application.eager_load!"

可以在关键位置添加日志，确认模块冻结状态：

Rails.logger.info "模块冻结状态：#{Override::CashOverride::Api.frozen?}"

生产环境关闭eager_load会带来以下问题：

• 首次请求响应变慢（需要按需加载文件）
• 内存占用升高（重复加载文件的缓存开销）
• 启动时无法发现加载错误，只能在请求时暴露，增加排查难度
  因此生产环境绝对不能依赖这个临时方案，必须解决根因。

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