pytest-mock不能直接拦截requests.get,因其仅为unittest.mock的封装,需按被测代码实际导入方式patch对应路径,如import requests则patch"api_client.requests.get",from requests import get则patch"api_client.get",且须正确配置mock对象的json方法和status_code。

pytest-mock 为什么不能直接拦截 requests.get?
因为 pytest-mock 本身不提供网络层拦截能力,它只是 unittest.mock 的轻量封装。你 mock 的必须是「被测代码里实际 import 并调用的对象」,而不是底层 socket 或 requests 库的内部函数。
常见错误现象:requests.get 调用依然发出真实 HTTP 请求,mock 像没生效一样;或者 mock 成功但测试结果和预期不符,其实是 patch 错了位置。
- 确认被测函数里怎么写的——比如是
import requests后调用requests.get(...),那就得 patchrequests.get - 如果被测模块是
from requests import get,就得 patchyour_module.get,不是requests.get - patch 必须在被测函数所在的模块层级生效,路径写错一个点(比如少写包名)就完全不生效
正确 patch requests.get 的三种典型写法
取决于你的导入方式和模块结构。下面三个例子都基于被测函数在 api_client.py 中:
场景1: api_client.py 里写的是 import requests → requests.get(...)
立即学习“Python免费学习笔记(深入)”;
def test_fetch_user(mocker):
mock_resp = mocker.Mock()
mock_resp.json.return_value = {"id": 1, "name": "alice"}
mocker.patch("api_client.requests.get", return_value=mock_resp)
result = fetch_user(1)
assert result["name"] == "alice"
场景2: api_client.py 里是 from requests import get → get(...)
- 必须 patch
api_client.get,不是requests.get - 否则 mock 注入不到局部作用域里的
get名字上
场景3: 使用 requests.Session() 实例发请求
- 要 mock
Session.get方法,或直接 mock 整个 session 实例 - 注意:
mocker.patch("api_client.session.get")前提是你在模块里定义了全局session = requests.Session()
返回值设错导致 JSON 解析失败
mock 对象默认不带 .json() 方法,直接调用会报 AttributeError: Mock object has no attribute 'json'。这不是 requests 问题,是 mock 没配好。
- 最简方案:用
mocker.Mock(return_value={"id": 1})不够,得显式加方法:mocker.Mock(json=mocker.Mock(return_value={"id": 1})) - 更稳写法:用
Response类模拟(需 from requests.models import Response),设置_content和status_code - 别只 mock 返回值,漏掉
status_code—— 很多业务逻辑会检查r.status_code == 200
测试异步 API 调用(aiohttp)怎么办?
pytest-mock 对 aiohttp.ClientSession 同样无效,原因一致:你要 patch 的是被测代码里实际 await 的那个对象。
- 如果被测函数里是
async with aiohttp.ClientSession() as session:→await session.get(...),那得 patchsession.get,但 session 是运行时创建的,得用mocker.patch.object或提前构造 mock session - 推荐做法:把 session 作为参数传入被测函数,测试时直接传 mock,避免 patch 动态对象
- 别试图 mock
aiohttp.request全局函数——它不是被调用路径上的目标
真实项目里最容易被忽略的,是 patch 路径和被测代码中 import 方式的耦合关系。写对一次不难,但重构时改了 import 方式,mock 就悄无声息地失效了。每次 CI 报网络超时失败,先查 patch 路径是不是还对得上。


















