移除常量后已设置autoload仍触发NameError的原因及解决方法

我给P::Foo设置了autoload，第一次调用正常，但移除常量后第二次调用就报错，哪怕重新设置autoload也不行，这是为什么？该怎么解决？

场景代码 #

第一次调用正常，移除常量后报错：

module P; end

P.autoload(:Foo, "#{__dir__}/foo.rb")
P::Foo.new.foo # 运行正常

P.send(:remove_const, :Foo)
P::Foo.new.foo # 报错

重新设置autoload仍无效：

P.send(:remove_const, :Foo)
P.autoload(:Foo, "#{__dir__}/foo.rb")
P::Foo.new.foo # 还是报错

原因解析 #

Ruby的autoload有两个核心特性导致这个问题：

• 常量触发过autoload加载后，Ruby会在内部记录这个常量的「加载尝试状态」，哪怕用remove_const删除了常量，这个标记不会自动清除。再次引用时，Ruby直接判定常量不存在并抛出错误，不会再执行autoload逻辑。
• autoload注册是一次性的：常量成功加载后，对应的autoload规则会被自动移除。就算手动删除了常量，旧的autoload规则已经消失，重新注册时因为内部的加载标记存在，依然不会触发加载。

解决办法 #

要彻底重置状态，需要按顺序清除autoload注册、删除常量，最后重新注册autoload。Ruby 2.0+提供了remove_autoload方法来完成这个操作：

module P; end

# 第一次正常使用
P.autoload(:Foo, "#{__dir__}/foo.rb")
P::Foo.new.foo # 正常运行

# 清理并重新注册
P.remove_autoload(:Foo) if P.autoload?(:Foo) # 先移除autoload注册
P.send(:remove_const, :Foo) if P.const_defined?(:Foo, false) # 删除常量
P.autoload(:Foo, "#{__dir__}/foo.rb") # 重新注册autoload

P::Foo.new.foo # 现在可以正常运行了

如果需要频繁卸载/重载常量，autoload本身不是最佳选择——它的设计初衷是懒加载一次性加载的常量，不适合频繁动态变更的场景。更推荐使用Rails的require_dependency，或者手动管理文件加载和常量的生命周期。

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