python单元测试中时间相关逻辑应通过冻结或模拟时间来保证可控性，推荐使用freezegun库，也可用unittest.mock.patch细粒度打桩，避免直接修改内置时间函数。
在Python单元测试中，时间相关逻辑（如超时判断、缓存过期、定时任务触发）容易因真实时间流逝而变得不可控、不稳定甚至难以覆盖。解决这类问题的核心思路是：不依赖系统时钟，而是用可控的方式“模拟”或“冻结”时间。主流方法包括使用freezegun库冻结时间、手动替换time.time或datetime.datetime等函数，以及借助unittest.mock.patch进行细粒度打桩。
用 freezegun 冻结时间（推荐首选）
freezegun 是专为时间冻结设计的轻量库，语法简洁、支持多种时间类型（datetime、time、calendar），且与 pytest 和 unittest 兼容良好。
- 安装：
pip install freezegun - 作为装饰器使用（冻结指定时间点）：
@freeze_time("2023-01-01 12:00:00")<br>def test_cache_is_expired():<br> cache = Cache(expire_in_seconds=3600)<br> assert cache.is_expired() == False # 此时刚创建，未过期<br> # 模拟 1 小时后<br> freeze_time.tick(delta=timedelta(hours=1))<br> assert cache.is_expired() == True - 也可在
with语句中临时冻结：with freeze_time("2023-01-01"): <br> assert datetime.now().year == 2023
用 unittest.mock.patch 替换时间函数（适合细粒度控制）
当需要仅 mock 某个模块内部调用的 time.time() 或 datetime.utcnow()，而不影响全局时间行为时，patch 更精准。
- mock 当前模块中的
datetime：from unittest.mock import patch<br>from datetime import datetime<br><br>def test_order_created_at():<br> with patch('my_module.datetime') as mock_dt:<br> mock_dt.utcnow.return_value = datetime(2023, 1, 1, 10, 0, 0)<br> order = create_order()<br> assert order.created_at == datetime(2023, 1, 1, 10, 0, 0) - 注意路径要写对：patch 的目标是「被测试代码里导入并使用的对象所在位置」，不是定义位置（例如若代码中写了
from datetime import datetime，则应 patch'my_module.datetime'）。
避免直接修改 time.time 等内置函数（不推荐）
虽然可以手动赋值 time.time = lambda: 1672548000.0，但这种全局篡改风险高：易遗漏还原、干扰其他测试、破坏并发安全性。
立即学习“Python免费学习笔记（深入）”；
- 副作用明显：可能让同一进程内其他测试或日志模块误判时间
- 无自动清理机制：需手动恢复原函数，容易出错
- 不适用于 pytest 的 fixture 自动管理场景
处理依赖时间的第三方库（如 APScheduler、redis-py）
部分库内部硬编码调用 time.time() 或 datetime.now()，此时 freezegun 通常仍有效——它会自动 patch 多数标准时间接口。若遇到例外：
- 确认该库是否用了非标准方式（如
ctypes调用系统 clock） - 优先尝试
@freeze_time，失败再针对性 patch 其内部时间调用点 - 对于 redis 缓存 TTL 测试，可结合
fakeredis使用，完全跳过真实 Redis 时间依赖
