在Minitest中优雅存根多个类方法并验证指定方法未被调用的最佳实践

这个场景太常见了——测试某个方法只触发预期的依赖调用，同时确保其他无关方法完全没被执行。在Minitest里，有几种优雅的方式可以实现这个需求，我给你拆解两种最常用的最佳实践：

1. 使用assert_not_called断言（最推荐，语义化拉满） #

如果你用的是较新版本的Minitest，assert_not_called绝对是首选。这个断言专门用来验证某个方法在指定代码块中从未被调用，语义清晰到不需要额外注释，读代码的人一眼就能懂测试意图。

完整的测试代码如下：

test 'run_foo calls foo but does not call bar' do
  # 给foo创建带调用预期的mock
  foo_mock = Minitest::Mock.new
  foo_mock.expect :call, nil, []

  MyUtilityClass.stub :foo, foo_mock do
    # 用assert_not_called包裹测试逻辑，监控bar的调用情况
    assert_not_called(MyUtilityClass, :bar) do
      target = MyTestTarget.new
      target.run_foo
    end

    # 最后验证foo确实被调用了
    foo_mock.verify
  end
end

逻辑拆解： #

• 先给MyUtilityClass.foo存根一个mock，确保它会被调用（验证我们的目标方法确实触发了预期逻辑）
• 用assert_not_called(MyUtilityClass, :bar)包裹执行run_foo的代码，这个断言会自动监控bar的调用，如果它被执行，测试直接失败
• 最后验证foo的mock确实被调用，完成整个测试闭环

2. 使用Mock的times: 0预期（兼容旧版本Minitest） #

如果你的项目还在使用较老版本的Minitest（不支持assert_not_called），可以用Mock的times参数来明确指定某个方法绝对不能被调用。

代码示例：

test 'run_foo calls foo but does not call bar' do
  utility_mock = Minitest::Mock.new
  
  # 预期foo被调用1次（times:1是默认值，可以省略）
  utility_mock.expect :foo, nil, []
  # 明确要求bar被调用0次
  utility_mock.expect :bar, nil, [], times: 0

  # 同时把foo和bar存根到mock的对应方法上
  MyUtilityClass.stub :foo, -> { utility_mock.foo } do
    MyUtilityClass.stub :bar, -> { utility_mock.bar } do
      target = MyTestTarget.new
      target.run_foo

      # 一次性验证所有预期是否满足
      utility_mock.verify
    end
  end
end

逻辑拆解： #

• 创建一个统一的mock对象，同时管理foo和bar的调用预期
• times: 0告诉mock：bar这个方法绝对不能被调用
• 执行目标方法后，调用utility_mock.verify，如果bar被意外调用，mock会直接抛出错误，提示预期调用0次但实际被调用了1次

一些额外的最佳实践小提示 #

• 优先选语义化的断言：assert_not_called比mock的times:0可读性更强，能让测试代码的意图更明确
• 不要过度存根：只存根你需要验证的方法，无关方法没必要强行存根，保持测试简洁
• 测试命名要明确：比如上面的测试方法名run_foo calls foo but does not call bar，看到名字就知道这个测试在验证什么，后期维护更轻松

备注：内容来源于stack exchange，提问作者LondonAppDev