直接调用真实API不适合单元测试,因其拖慢速度、引入网络不稳定、依赖第三方状态,还可能触发限流或产生费用;应使用pytest-mock等工具模拟依赖以保障隔离性、快速性与确定性。

为什么直接调用真实API不适合单元测试
真实API调用会拖慢测试速度、引入网络不稳定、依赖第三方服务状态,还可能触发限流或产生费用。pytest本身不提供mock能力,得靠unittest.mock(Python 3.3+内置)或pytest-mock插件配合使用——后者更轻量,推荐优先选它。
用pytest-mock快速mock requests.get
先装插件:pip install pytest-mock。它自动注入mocker fixture,不用手动import或patch管理生命周期。
常见错误是只mock了requests.get函数,却没控制返回值结构,导致被测代码抛AttributeError: 'Mock' object has no attribute 'json'。
- 必须显式设置
return_value.json.return_value,不能只设return_value为字典 - 如果被测函数里用了
response.raise_for_status(),还得 mockraise_for_status方法(空实现即可) - 路径要写对:mock的是你代码里「导入并调用」的位置,不是
requests源码位置。比如你在api_client.py里写了from requests import get,就要 mock"api_client.get";如果写的是import requests再用requests.get,就得 mock"api_client.requests.get"
def test_fetch_user(mocker):
mock_response = mocker.Mock()
mock_response.json.return_value = {"id": 123, "name": "Alice"}
mock_response.raise_for_status.return_value = None
mocker.patch("api_client.requests.get", return_value=mock_response)
result = fetch_user(123)
assert result["name"] == "Alice"
mock异步API(aiohttp)要注意协程返回
用aiohttp时,session.get()返回的是协程对象,不能直接return_value=mock_response。得用mocker.AsyncMock(Python 3.8+)或async_mock第三方包。
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
立即学习“Python免费学习笔记(深入)”;
-
return_value必须是可await的对象,mocker.AsyncMock自带此行为 - 同样要链式设置
.json.return_value和.raise_for_status - 测试函数必须加
async def,且用await调用被测函数
async def test_fetch_user_async(mocker):
mock_response = mocker.AsyncMock()
mock_response.json.return_value = {"id": 456}
mock_response.raise_for_status.return_value = None
mocker.patch("api_client.aiohttp.ClientSession.get", return_value=mock_response)
result = await fetch_user_async(456)
assert result["id"] == 456
避免全局patch污染后续测试
mocker.patch默认作用域是当前测试函数,一般够用。但若在conftest.py里做模块级patch,或用了autospec=True又没传全参数,容易让其他测试意外失败。
- 不要在
setup_method或pytest_configure里做patch,除非明确需要跨测试共享 - 用
autospec=True能校验调用签名,但会拒绝任何未声明的属性访问(比如误写resp.josn()),调试时反而难定位——建议初期关掉,稳定后再开 - 如果mock对象被多次调用,用
mock_calls断言调用次数和参数:assert requests.get.call_count == 1,assert requests.get.call_args[0][0] == "https://api.example.com/users/123"
mock的本质是隔离依赖,但过度mock会让测试失去对集成路径的覆盖。真正难测的,往往是错误处理分支——比如网络超时、JSON解析失败、HTTP 500响应。这些场景下,别只mock成功路径,记得把side_effect设成requests.exceptions.Timeout或ValueError来触发异常分支。

















