mock.patch没生效最常见的原因是目标路径写错,应patch被测函数实际访问的位置而非import位置;可用patch.object更安全,side_effect控制多返回值,assert_called系列验证调用,fixture封装patch避免重复。

mock.patch 为什么没生效?
最常见的原因是 patch 的目标位置写错了——不是写被测试代码里 import 的地方,而是写「被测试对象实际访问它的地方」。比如你在 utils.py 里写了 requests.get(),但测试时却 patch requests.get 在 test_utils.py 中的导入路径,那 mock 就不会触发。
实操建议:
- 用
patch('module_name.ClassName.method_name'),其中module_name是被测函数所在模块(如utils),不是你 import 它的地方 - 如果被测函数在
app.services.api_client里调用了httpx.post,就该 patch'app.services.api_client.httpx.post' - 用
patch.object更安全:比如patch.object(httpx, 'post'),避免字符串路径出错 - pytest + unittest.mock 混用时,别在 fixture 里只 return Mock() 而不 patch,那只是造了个假对象,没替换掉运行时调用链
如何让 mock 返回不同值以覆盖分支逻辑?
单次调用返回固定值不够用,比如一个函数里两次调用 json.loads(),第一次成功、第二次抛异常,就得控制返回行为。
实操建议:
- 用
side_effect:传列表(按调用顺序返回)、异常类(如ValueError)、或函数(可带参数做判断) mock_obj.method.side_effect = [True, False, ValueError('timeout')]—— 第三次调用直接 raise- 需要检查入参再决定返回?写个函数:
lambda x: {'id': 1} if 'user' in x else {} - 注意:
return_value和side_effect互斥,设了后者,前者会被忽略
mock 之后怎么验证调用是否符合预期?
光 mock 不验证,等于白 mock。容易漏掉参数拼错、调用次数不对、甚至根本没调用。
实操建议:
- 用
assert_called()、assert_called_once()、assert_not_called()快速确认是否触发 - 查参数:
mock_obj.method.assert_called_with(url='https://api.example.com', timeout=5) - 查多次调用:
mock_obj.method.assert_has_calls([call(...), call(...)], any_order=False) - 别忘了
call要从unittest.mock导入,pytest 不自带 - 如果 mock 的是类实例方法,记得验证的是实例上的方法调用,不是类本身
pytest.fixture + mock 怎么组织才不混乱?
把 patch 写进每个 test 函数太重复;全塞进 conftest.py 又容易过度共享、干扰其他测试。
实操建议:
- 优先用 fixture 封装 patch:用
@pytest.fixture+with patch(...)或patch.start()/stop() - scope 设为
'function',避免跨测试污染;需要共享时再升到'module' - fixture 返回 mock 对象本身,而不是 patcher,方便 test 函数里做 assert
- 慎用 autospec=True:虽然能自动校验签名,但在 mock 类方法或复杂继承时可能报
AttributeError,先关掉试试 - mock 对象默认允许任意属性访问,若要严格限制,加
spec_set=True,访问不存在属性会立刻报错
真实项目里,mock 的边界往往比想象中模糊——比如你以为只 mock 了数据库,结果 ORM 自动触发了缓存 client 的初始化。多打一行 print(mock_obj.__dict__) 或用 mock_obj.method.call_args_list 看看到底发生了什么,比猜快得多。