python单元测试中应mock时间以确保稳定，推荐用freezegun冻结datetime/time等模块行为，支持装饰器和上下文管理器；手动patch需注意目标路径；time.time()和时区逻辑也需相应处理。
在Python单元测试中，时间相关的逻辑（比如依赖 datetime.now()、time.time() 或定时任务）如果不做隔离，会导致测试不稳定、不可重现，甚至因时区、系统时间跳变而失败。最稳妥的做法是“mock时间”，让测试在可控的时间点运行。
用 freezegun 冻结时间（推荐）
freezegun 是最常用、最直观的时间 mock 工具，能冻结 datetime、time、calendar 等模块的行为，支持装饰器、上下文管理器两种用法。
- 安装：
pip install freezegun - 装饰器方式（适合单个测试函数）：
from freezegun import freeze_time
from datetime import datetime
@freeze_time("2024-01-01 12:00:00")
def test_order_created_at_is_frozen():
order = create_order() # 内部调用 datetime.now()
assert order.created_at == datetime(2024, 1, 1, 12, 0, 0)
- 上下文管理器方式（适合需多次校验不同时间点的场景）：
def test_status_changes_over_time():
with freeze_time("2024-01-01 10:00:00"):
task = start_task()
assert task.status == "running"
with freeze_time("2024-01-01 10:05:00"):
task.check_timeout()
assert task.is_timed_out() # 假设超时阈值为5分钟
立即学习“Python免费学习笔记（深入）”；
手动 patch datetime（原生方案，适合轻量场景）
若不想引入第三方库，可用 unittest.mock.patch 替换 datetime 类，但要注意 patch 的目标必须是**被测代码导入的位置**，不是 datetime 模块本身。
- 错误示范（patch 模块本身，无效）：
@patch('datetime.datetime') - 正确做法（patch 被测模块中使用的路径）：
@patch('my_module.datetime')
# my_module.py
from datetime import datetime
def get_timestamp():
return datetime.now().isoformat()
# test_my_module.py
from unittest.mock import patch
from my_module import get_timestamp
@patch('my_module.datetime')
def test_get_timestamp(mock_datetime):
mock_datetime.now.return_value = datetime(2024, 1, 1, 9, 0, 0)
assert get_timestamp() == "2024-01-01T09:00:00"
处理 time.time() 和相对时间逻辑
有些逻辑基于秒级时间戳（如缓存过期、重试间隔），需 mock time.time()。同样建议优先用 freezegun（它自动覆盖 time.time），或单独 patch：
- freezegun 中
time.time()会返回对应时间戳（如"2024-01-01"→1704067200.0） - 手动 patch 示例：
@patch('time.time', return_value=1704067200.0) - 注意：涉及
time.sleep()的测试，应 mock 它并验证是否被调用，而非真实等待
时区与真实时间交互的注意事项
如果代码显式使用 pytz、zoneinfo 或 datetime.now(tz=...)，freezegun 默认按系统本地时区冻结；如需指定时区，可传入 tz_offset 或使用 timezone 参数：
@freeze_time("2024-01-01 12:00:00", tz_offset=+8) # 模拟东八区
def test_in_china_timezone():
assert datetime.now().strftime("%Z") == "CST"
- 更严谨的做法：在测试中显式构造带时区的
datetime对象做断言，避免依赖系统默认时区 - 生产代码中尽量统一使用 UTC 时间存储和计算，测试时也以 UTC 为准，减少歧义
