RSpec中allow存根跨context持久化问题咨询

一、RSpec allow 的核心作用域规则 #

• 默认情况下，allow（包括带存根逻辑的expect）的作用域是当前测试示例（example）或它所在的上下文（context/describe）。RSpec会在每个示例执行完成后自动重置所有存根、mock，这是默认的测试隔离机制。
• 如果把存根写在before(:all)块里，它会在整个上下文的所有示例中生效，而且不会自动重置——这是很多人踩坑的高频点。
• 针对File.read这类全局类方法的存根，要注意：如果你的单例模块是全局唯一实例，可能会因为单例的状态保留，和RSpec的存根重置时机产生冲突。

二、你的问题核心原因 #

这是单例测试的典型问题：

1. AtomicCards::Mana::Production作为单例，全局只有一个实例，它内部可能缓存了File.read的结果，或者第一次调用后保留了状态。就算RSpec重置了File.read的存根，单例还是会用之前缓存的旧值，导致第四个测试看起来像是存根还在生效。
2. 你之前尝试的before块、.with参数配置本身没问题，但单例的状态没被重置，才是根本问题。

三、具体排查与解决步骤 #

1. 确认存根的作用域是否正确 #

• 检查第三个context里的存根是不是写在before(:all)里了，如果是，改成before(:each)，确保每个示例前重新设置存根，示例结束后自动被RSpec重置。
• 正确写法示例：

  context "当JSON文件存在且数据合法时" do
    before(:each) do
      allow(File).to receive(:read).with("指定的文件路径.json").and_return('{"mana": 100}')
    end
  
    it "返回解析后的正确数据" do
      expect(AtomicCards::Mana::Production.from).to eq({"mana" => 100})
    end
  end
  

2. 强制重置单例状态 #

单例的状态会在测试之间保留，必须手动重置：

• 在测试文件的describe块里添加after(:each)，每次测试后销毁单例实例：

  RSpec.describe AtomicCards::Mana::Production do
    after(:each) do
      # 根据你的单例实现方式重置，这里是通用写法
      if self.class.instance_variable_defined?(:@instance)
        self.class.remove_instance_variable(:@instance)
      end
      # 如果是用Ruby标准库Singleton模块实现的，用下面这句：
      # Singleton.__init__(AtomicCards::Mana::Production)
    end
  
    # 你的测试上下文和示例写在这里
  end
  

3. 验证存根是否真的被重置 #

在第四个测试里加调试断言，确认File.read是否真的被调用了：

it "没有存根时读取真实文件" do
  expect(File).to receive(:read).with("指定的文件路径.json").and_call_original
  result = AtomicCards::Mana::Production.from
  # 这里断言result符合真实文件的内容
end

如果这个测试失败，说明单例没调用File.read，而是用了缓存；如果通过，说明存根确实被重置了。

4. 替代方案：避免全局类存根 #

频繁存根File这类全局类容易出问题，可以把文件读取逻辑封装成可替换的依赖：

# 生产代码调整
module AtomicCards::Mana::Production
  class << self
    attr_writer :file_reader

    def file_reader
      @file_reader ||= ->(path) { File.read(path) }
    end

    def from
      raw_data = file_reader.call("指定的文件路径.json")
      JSON.parse(raw_data)
    end
  end
end

# 测试代码写法
context "当JSON文件存在且数据合法时" do
  before(:each) do
    AtomicCards::Mana::Production.file_reader = ->(_) { '{"mana": 100}' }
  end

  after(:each) do
    AtomicCards::Mana::Production.file_reader = nil
  end

  it "返回解析后的正确数据" do
    expect(AtomicCards::Mana::Production.from).to eq({"mana" => 100})
  end
end

这种方式不需要碰全局的File类，测试隔离性更好，也不容易出现跨测试的状态污染。

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