如何在Python测试中使用unittest.mock模拟外部API的返回结果？-Python教程-PHP中文网

mock.patch必须作用于被调用位置而非定义位置，因为python导入机制使函数在导入模块的命名空间中形成独立引用，patch需覆盖实际调用时解析的路径；例如service.py中from api_client import fetch_user，则必须@mock.patch('service.fetch_user')才能生效。

如何在python测试中使用unittest.mock模拟外部api的返回结果？

mock.patch 为什么必须作用于被调用位置，而不是定义位置？

很多人写完 mock.patch 却发现 mock 没生效，根本原因是 patch 的目标错了。比如你在一个模块 api_client.py 里定义了 fetch_user()，然后在 service.py 中 import 并调用它，那 mock 必须打在 service.py 中的引用点上，而不是 api_client.py 里函数定义处。

这是因为 Python 的 import 机制决定了：谁 import 了函数、谁调用了它，就该在谁的命名空间里 patch。否则实际运行时仍会走真实网络请求。

✅ 正确： @mock.patch('service.fetch_user')（假设 service.py 写的是 from api_client import fetch_user）
❌ 错误： @mock.patch('api_client.fetch_user')（除非你在测试文件里直接 import 并调用它）
调试技巧：在被测函数里加 print(fetch_user)，看输出的 module 路径，就能确认该 patch 哪个路径

如何让 mock 返回不同状态码和 JSON 数据？

Mock 对象默认返回空对象，但 HTTP 请求通常需要模拟 response.status_code 和 response.json() 行为。不能只设 return_value，得构造一个带属性和方法的 mock 响应。

最简方式是用 Mock + configure_mock，或直接返回一个自定义对象。避免用 side_effect 返回原始 dict——因为真实 requests.Response 对象有 .json() 方法，而 dict 没有。

python-code-analyz

专业Python代码分析与优化，支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。

下载

推荐写法：

mock_response = Mock()
mock_response.status_code = 200
mock_response.json.return_value = {"id": 123, "name": "Alice"}

处理异常场景：mock_response.raise_for_status.side_effect = requests.HTTPError("404 Not Found")
若需多次调用返回不同结果，用 side_effect=[mock_resp1, mock_resp2, requests.ConnectionError]

测试异步函数时，patch requests.get 为什么无效？

如果你用的是 aiohttp 或 httpx.AsyncClient，requests.get 的 patch 完全不起作用——因为根本没调用它。async 函数不会走 requests 同步栈。

对应要 patch 的目标变了：aiohttp.ClientSession.get 或 httpx.AsyncClient.get，而且得配合 async with 和 await 的调用链。

对 aiohttp：@mock.patch('aiohttp.ClientSession.get')，然后返回一个带 __aenter__ 和 __aexit__ 的 mock，内部再 mock .json()
更稳妥的做法：改用 respx 或 httpx.MockTransport，它们专为 async HTTP mocking 设计，行为更贴近真实
注意：unittest.mock 不原生支持 async 上下文管理器，硬 patch 容易漏掉 await 链中的某一层

为什么 patch 后测试通过，但线上仍失败？

mock 只掩盖了外部依赖，不验证你的解析逻辑是否能处理真实 API 的边界情况。比如 mock 返回 {"name": "Alice"}，但真实 API 在用户不存在时可能返回 {} 或 {"error": "not found"}，而你的代码没做 key 存在性检查，就会抛 KeyError。

建议每类 mock 响应都覆盖：200 成功、404、500、空 body、字段缺失、字段类型错（如 "id": "123" 字符串而非整数）
别只 mock json()，也 mock text 和 raise_for_status()，尤其当代码里写了 resp.raise_for_status() 却没 catch
真实 API 可能返回压缩内容（gzip）、重定向响应、或带 cookie 的 session，这些 mock 很难完整模拟——这时候单元测试不是万能的，得靠集成测试补位