如何在Python中利用pytest-mock模拟第三方接口

秋磊小哥_6728

秋磊小哥_6728

2026-10-04

871人浏览

原创

根本原因是patch路径必须匹配函数被导入和使用的位置,而非定义位置;如service.py中import requests后调用requests.get,则应patch'service.requests.get',而非'requests.get'。

如何在python中利用pytest-mock模拟第三方接口

mock.patch 为什么总 patch 不到目标函数

根本原因不是写法错,而是导入路径写错了——patch 必须按「测试代码里实际导入的位置」去打补丁,而不是按函数定义的位置。比如你在 service.py 里写了 requests.get,但在测试文件中是 from service import fetch_data,那就要 patch 'service.requests.get',而不是 'requests.get'。

常见错误现象:AttributeError: does not have the attribute 'get' 或 mock 生效但接口仍被真实调用。

  • 检查被测函数内部 import 方式(是 import requests 还是 from requests import get)
  • 确认 patch 路径以「测试模块能访问到该对象的位置」为准,通常为 模块名.类名.方法名 或 模块名.函数名
  • 用 pytest-mock 的 mocker.patch 比原生 patch 更安全,它自动 handle scope 和 cleanup

用 mocker.patch 做返回值控制的三个关键参数

mocker.patch 默认返回一个 Mock 实例,但第三方接口返回的是 JSON、status_code、headers 等结构化数据,必须手动设好这些属性,否则下游解析会报错。

典型使用场景:模拟 requests.post 返回成功响应,或模拟网络超时异常。

  • return_value:设整个响应对象,比如 mocker.Mock(status_code=200, json=lambda: {"id": 123})
  • side_effect:用于抛异常(如 requests.exceptions.ConnectionError)或动态返回不同结果(列表或函数)
  • 别漏掉 text 或 content 属性——有些旧代码不用 .json(),而是直接解析 .text,不设会触发 AttributeError

示例:

mocker.patch('service.requests.post', return_value=mocker.Mock(
    status_code=201,
    json=lambda: {'token': 'abc'},
    text='{"token": "abc"}'
))

测试异步接口时,patch aiohttp.ClientSession.post 报 RuntimeError

直接 patch aiohttp.ClientSession.post 会失败,因为它是绑定方法(bound method),且返回的是 ClientResponse 协程对象,mock 需要支持 await。

Python 环境工具专业版
Python 环境工具专业版

Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能

下载

正确做法是 patch 整个 session 的创建过程,或 mock 返回的 response 对象本身,并确保它可 await。

  • 推荐方式:patch aiohttp.ClientSession 类,让它实例化后返回一个预设的 mock session
  • response mock 必须实现 __await__ 或用 AsyncMock(Python 3.8+);pytest-mock 的 mocker 在较新版本中已支持 mocker.AsyncMock
  • 若用 side_effect 返回协程,需用 async def 函数或 coroutine 对象,不能直接 return 普通 dict

为什么测试通过但线上仍调用真实接口

最常被忽略的一点:patch 生效范围只在装饰器/上下文管理器作用域内。如果被测函数内部又 import 了另一个模块,而那个模块里也调用了第三方接口,但你没对它 patch,就会漏掉。

还有更隐蔽的情况:日志、监控 SDK、全局钩子(如 sentry 的自动捕获)可能悄悄触发 HTTP 请求,它们不在主业务逻辑路径里,容易被遗忘。

  • 打开 debug 日志,加 logging.basicConfig(level=logging.DEBUG),看测试运行时是否真有 POST 或 GET 输出
  • 用 mocker.patch('requests.Session.request') 统一拦截所有 requests 底层调用,比 patch get/post 更彻底
  • CI 环境里注意是否加载了真实配置(如环境变量 API_BASE_URL 没被覆盖),导致 mock 路径和实际请求 URL 不匹配

复杂点永远在路径判断和调用链深度上——多一层 import,就多一个可能漏掉的 patch 点。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1931

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5444

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1869

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

33097

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3887

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3907

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1283

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

616

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3023

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程