Rails开发环境修改文件重载后Marshal.dump丢失类引用问题

使用Marshal.dump/load处理缓存（哈希结构{ <String> => <Manifest::Js::Source> }），开发环境下修改源文件后，Marshal.dump抛出错误"Manifest::Js::Source can't be referred to"，重启Rails服务器后恢复正常。该问题在Rails 3.x/Ruby 2.3（Windows）、Rails 7/Ruby 2.7.7（Linux）环境下均能复现。

补充调查细节 #

缓存存储于Rails.application的实例变量中，源码自动加载后，缓存内的实例变为“僵尸实例”——出现value.is_a?(value.class.name.constantize) => false的异常情况。尝试替换为新实例：

source_file_cache.to_a.each {|k, s|
    source_file_cache[k] = s.class.name.constantize.new(s) unless s.is_a?(Source)
}
# 注：s.class.new(s) 生成的仍是僵尸实例

替换后缓存看似清理干净，但Marshal.dump仍抛出相同错误。

• 彻底清除旧类关联引用
  僵尸实例的核心原因是Rails开发环境重载类时，原Manifest::Js::Source类对象已被替换，但缓存实例仍指向旧类对象。仅替换实例可能无法清理Marshal内部留存的旧类引用，需：

  • 直接清空整个缓存哈希，重新生成所有Manifest::Js::Source实例，避免复用旧实例的任何属性传递（防止隐性携带旧类引用）
  • 或者在类重载触发后，直接重置Rails.application上的缓存实例变量为全新空哈希

• 避免用Marshal存储类实例
  Marshal对Ruby类的内存引用依赖极强，开发环境类重载场景下极易出错。可以：

  • 将Manifest::Js::Source的属性序列化为哈希、字符串等基础类型存储，dump/load时手动完成类型转换，示例：

    # 存储时转为基础类型哈希
    cache_to_dump = source_file_cache.transform_values { |s| s.attributes }
    Marshal.dump(cache_to_dump, file)
    
    # 加载时重建实例
    loaded_cache = Marshal.load(file).transform_values { |attrs| Manifest::Js::Source.new(attrs) }
    

• 临时禁用开发环境类自动重载
  在config/environments/development.rb中设置config.cache_classes = true，验证问题是否由类重载导致。此方法会失去开发环境自动重载的便利，仅用于排查。

• 替换序列化方式
  改用JSON、YAML（需注意属性序列化兼容性）或MessagePack等不依赖Ruby类内存引用的序列化库，从根源避免类重载引发的引用失效问题。

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