freeze_time 不能直接跨天是因为它默认只冻结当前时刻而不自动推进时间；需用 move_to 显式跳转或设 tick=true，但后者精度低，跨天测试还需统一时区（如 tz_offset=0）并注意 fixture 作用域。
freeze_time 为什么不能直接跨天？
因为 freeze_time 默认只冻结当前时刻，不自动推进时间；你调用一次 freeze_time("2024-01-01")，之后所有 datetime.now() 都返回这个固定时间——它不会“走”，更不会“走到第二天”。想测跨天逻辑（比如凌晨任务、会话过期），必须手动控制时间跳转。
- 常见错误现象：
AssertionError：预期“第二天凌晨触发”，实际时间始终卡在冻结起点 - 正确做法：用
tick=True或嵌套多次freeze_time，或配合move_to显式跳转 -
tick=True会让时间随真实流逝而“走”，但精度低、不可控，不适合精确到秒的超时测试
测试超时逻辑：用 move_to 精确跳转到关键时间点
超时判断通常依赖 time.time() 或 datetime.now() 的差值。冻结后靠 move_to 模拟“等待”是最稳的方式——它不依赖系统时钟，也不引入真实延迟。
- 使用场景：JWT 过期验证、缓存 TTL 到期、任务重试窗口检查
- 参数差异：
move_to接受字符串（如"2024-01-01 00:05:00"）、datetime对象，或相对偏移（timedelta(minutes=5)） - 性能影响：零开销，纯内存操作；比
time.sleep(300)快且稳定 - 示例：
@freeze_time("2024-01-01 00:00:00") def test_token_expires_in_5_minutes(): token = generate_token(expires_in=300) # 5 分钟 # 跳到刚好过期时刻 freeze_time().move_to("2024-01-01 00:05:00") assert is_token_expired(token) == True
跨天测试要避开 timezone 和 naive/datetime 混用
如果你的业务逻辑里用了 datetime.utcnow()，但 freeze_time("2024-01-01") 默认生成的是本地时区的 naive datetime，就可能因时区错位导致“看似跨天实则没跨”的 bug。
- 常见错误现象：
datetime.now() >= tomorrow_start始终为 False，即使已move_to("2024-01-02") - 根本原因：比较了带 tzinfo 的对象和 naive 对象，Python 3.6+ 直接抛
TypeError: can't compare offset-naive and offset-aware datetimes - 解决方式：统一用 aware datetime —— 在
freeze_time中显式指定 tz，例如@freeze_time("2024-01-01", tz_offset=0)（UTC），或用pytz.UTC构造 - 兼容性注意：Python 3.9+ 推荐用
zoneinfo.ZoneInfo("UTC")，老版本仍需pytz
fixture 复用时 freeze_time 的作用域容易被忽略
pytest fixture 里用 freeze_time，如果没设 scope="function" 或没正确 yield，会导致时间状态污染后续测试——前一个测试 move_to("2024-01-02")，下一个测试的起点就从那天开始，而不是默认的冻结起点。
立即学习“Python免费学习笔记（深入）”；
- 最容易踩的坑：写了个 session-scoped 的 time-freezing fixture，结果所有测试共享同一个“时间指针”
- 实操建议：优先用函数级装饰器（
@freeze_time(...)），或 fixture 中显式管理生命周期@pytest.fixture def frozen_now(): with freeze_time("2024-01-01") as ft: yield ft # ft 是 FreezegunState 实例，支持 move_to/tick 等 - 别依赖
freeze_time().start()+.stop()手动配对，pytest fixture 的 setup/teardown 更可靠
时间不是线性的，但测试里的“时间”得是可重复、可定位的坐标点。freeze_time 不是时间机器，它是快门——按下去定格，再按下去换帧。跨天、超时、时区，本质都是在找对那个“按快门”的时机和位置。
