如何在Minitest中Stub系统时钟以固定测试日期？

不同技术栈都有成熟的工具来实现系统时钟的Stub，以下是几种常见场景的实现方式：

Ruby/Rails 环境 #

Rails生态里最常用的是Timecop gem，它能直接冻结或快进/回退系统时间，完全隔离真实时间对测试的影响：

require 'timecop'

# 用上下文管理器包裹测试逻辑，固定时间到2024-06-24
Timecop.freeze(DateTime.new(2024, 6, 24)) do
  # 这里执行的所有日期/时间相关调用都会返回固定值
  assert_equal Date.today, Date.new(2024, 6, 24)
end

如果用RSpec，还可以通过全局钩子批量设置：

RSpec.configure do |config|
  config.around(:example, freeze_time: ->(date) { date }) do |example|
    target_date = example.metadata[:freeze_time]
    Timecop.freeze(DateTime.parse(target_date)) { example.run }
  end
end

# 测试用例里直接标记要固定的日期
it '验证过期逻辑', freeze_time: '2024-06-24' do
  # 测试代码
end

Python 环境 #

用freezegun库就能轻松搞定，支持装饰器和上下文管理器两种方式：

from freezegun import freeze_time
import datetime

# 装饰器方式，直接固定测试函数的时间
@freeze_time("2024-06-24")
def test_expired_items():
    assert datetime.date.today() == datetime.date(2024, 6, 24)
    # 执行你的日期敏感逻辑测试

# 上下文管理器方式，灵活控制时间范围
def test_upcoming_events():
    with freeze_time("2024-06-24"):
        # 这里的时间被固定，外部不受影响
        assert datetime.datetime.now().date() == datetime.date(2024, 6, 24)

Java 环境 #

Java 8+推荐用Clock类配合Mockito来替换系统时钟，适合依赖注入的场景：

import java.time.Clock;
import java.time.LocalDate;
import java.time.ZoneId;

public class DateServiceTest {
    @Test
    void testDateSensitiveLogic() {
        // 创建固定到2024-06-24的Clock实例
        Clock fixedClock = Clock.fixed(
            LocalDate.of(2024, 6, 24).atStartOfDay(ZoneId.systemDefault()).toInstant(),
            ZoneId.systemDefault()
        );
        
        // 把固定Clock注入到待测试的服务中
        DateService service = new DateService(fixedClock);
        
        // 验证服务返回的日期是否符合预期
        assertEquals(LocalDate.of(2024, 6, 24), service.getCurrentDate());
    }
}

这种Stub系统时钟的方式，不需要动态修改测试夹具里的日期值，能让测试始终基于固定的数据集运行，彻底避免了真实时间变化导致的测试不稳定或夹具维护成本过高的问题。

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