补丁必须打在测试目标实际导入的位置而非定义位置;例如被测代码用from requests import get,则应patch('my_module.get')而非'requests.get',因导入后模块命名空间已持有函数引用,改原模块无效。

补丁必须打在测试目标实际导入的位置,而不是定义位置;否则 mock 会失效。
patch 打在哪儿才生效
Python 的 import 机制决定了:模块 A 用 from module_b import func 导入函数,测试时就得 patch A.func,而不是 module_b.func。因为导入后,A 模块的命名空间里已经持有了对 func 的引用,改 module_b 不影响 A 里的副本。
- 错误做法:
@patch('requests.get')—— 当被测代码是from requests import get时,这根本不会拦截调用 - 正确做法:
@patch('my_module.get')—— 补丁点必须和被测代码中实际使用的名称路径一致 - 验证方式:打印
my_module.get的id(),确认它确实是Mock实例,而非原始函数
装饰器 vs 上下文管理器:选哪个
装饰器写法简洁,但只适用于整个测试方法;上下文管理器更灵活,适合局部 patch 或多 patch 场景,且能避免装饰器顺序混乱问题。
- 装饰器顺序反向:多个
@patch时,最外层的 patch 参数在最右边(def test_foo(self, mock_b, mock_a)),容易错位 - 上下文管理器可嵌套:
with patch('a'), patch('b') as (m_a, m_b): ...,控制粒度更细 - 类级 patch 用装饰器更合适:
@patch('module.ClassA')放在TestCase类上,所有方法都生效
mock.return_value 和 mock.side_effect 的区别
return_value 是静态返回,适合模拟固定结果;side_effect 是动态行为,能抛异常、返回不同值、甚至执行真实函数。
-
mock.return_value = 42→ 每次调用都返回42 -
mock.side_effect = ValueError('boom')→ 每次调用都抛出该异常 -
mock.side_effect = [1, 2, 3]→ 第一次返回1,第二次2,第三次3,之后再调用就报StopIteration -
mock.side_effect = lambda x: x * 2→ 可实现带逻辑的响应
assert_called_* 系列方法的常见误用
这些断言不是“只要调用了就通过”,而是严格校验调用次数与参数——漏掉 _once 后缀或写错参数顺序,测试就可能放行错误行为。
-
mock.assert_called()只检查是否调用过,不关心参数,慎用 -
mock.assert_called_with(1, 'x', flag=True)要求最后一次调用完全匹配,但允许之前还有其他调用 -
mock.assert_called_once_with(1, 'x', flag=True)要求「只调用一次」且参数匹配,缺一不可 - 如果函数被调用多次但只关心某次,得用
mock.call_args_list[1]手动取第 2 次调用做比对
最容易被忽略的是 patch 作用域和导入时机的耦合——哪怕路径写对了,如果被测模块在 patch 前就完成了导入,mock 依然不会生效。建议把 patch 放在测试入口处,并确保被测模块是延迟导入或在测试函数内导入。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











