Rails初始化器创建自动加载类实例时Sorbet类型判定异常问题咨询

问题根源 #

开发模式下Rails默认通过Zeitwerk实现代码热重载，修改Foo或其依赖文件时，Zeitwerk会重新定义Foo类（生成新的类对象引用）。普通初始化器仅在应用启动时执行一次，其中创建的Foo实例属于旧类引用，和重载后的新Foo类不是同一个对象，因此触发Sorbet运行时类型检查报错。

可行修复方案 #

首选方案：迁移实例创建逻辑到Rails重载钩子 #

• 原理：Rails.application.reloader.to_prepare块会在应用启动完成、以及每次代码热重载完成后自动执行，能保证始终用最新的类创建实例、替换旧的常驻对象。
• 操作方式：将原初始化器中所有常驻实例的创建、DI容器绑定逻辑全部移到该钩子块中，示例代码：

# 放在任意初始化器文件中，比如 config/initializers/di_container.rb
Rails.application.reloader.to_prepare do
  # 替换为你实际的实例创建逻辑
  foo_instance = Foo.new
  MyDiContainer.register(:foo, foo_instance)
end

• 优势：完全保留热重载能力，修改代码后无需重启应用，Sorbet类型检查不会再触发误判，无额外性能损耗，适配大团队高频代码更新的场景。

方案二：调整核心类的热重载规则 #

• 适用场景：如果部分依赖类极少修改、本就需要重启才能生效，可以将其标记为不可自动重载，避免类被重新定义。
• 操作方式：将这类类移到Rails的autoload_once_paths路径下（该路径下的代码仅在应用启动时加载一次，不会被热重载），示例配置在config/application.rb中：

# 将lib/core加入仅自动加载路径
config.autoload_once_paths << Rails.root.join("lib", "core")

之后把不需要重载的Foo类放到lib/core/foo.rb即可，修改该文件后才需要重启应用，日常修改其他代码不会触发类重载错位。

方案三：适配DI容器的内置重载能力 #

• 如果你使用的是dry-container、trailblazer-container等成熟DI库，多数自带开发模式下的依赖重载钩子，会自动在类重载时更新容器内的绑定和实例。
• 操作方式：查阅所用DI库的开发模式配置项，开启对应的自动重载能力即可，无需手动维护to_prepare逻辑。

注意事项 #

• 不要随意降低Sorbet运行时类型检查的严格度，优先通过适配Rails重载机制的方案解决问题，避免丢失类型安全保障。
• 所有涉及依赖可变类的实例创建逻辑，都需要放入to_prepare块，避免遗漏导致的类型报错。

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