怎样在Python中通过pytest-mock监听函数调用次数

冬婷酱_3527

冬婷酱_3527

2026-10-04

456人浏览

原创

直接读取 mock 对象的 call_count 属性即可获取调用次数,它由 mocker.patch() 或 mocker.spy() 创建后立即可用,无需额外配置;需确保断言在 patch/spy 作用域内且目标代码已执行。

怎样在python中通过pytest-mock监听函数调用次数

pytest-mock里怎么获取mock对象的调用次数

直接看 call_count 属性,它就是专为这个设计的。只要用 mocker.patch() 或 mocker.spy() 创建了 mock,就能立刻读取——不需要额外配置或启动计数器。

常见错误是误以为要手动初始化计数器,或者在 patch 作用域外访问 call_count 导致值为 0(比如 patch 在 fixture 里但断言写在测试函数外面)。

  • mocker.patch('module.func') 返回的 mock 对象有 call_count
  • mocker.spy(obj, 'method') 返回的 spy 对象同样支持 call_count
  • 确保断言语句在被 patch/spy 的代码实际执行之后,且仍在同一作用域内

spy 和 patch 在调用计数上的关键区别

mocker.spy() 是“监听真实函数”,调用会真正执行,同时记录行为;mocker.patch() 是“替换函数”,原函数根本不会运行。选哪个取决于你是否需要验证副作用或返回值是否按预期发生。

比如你要确认某个日志函数被调用了 2 次,且每次参数不同,又得保证日志确实打出去了(比如触发了文件写入),那就必须用 spy;如果只是校验逻辑分支是否触发、不关心实际执行,patch 更轻量、更安全。

Li Python Sec Check
Li Python Sec Check

Python 安全规范检查工具:基于 CloudBase 规范、腾讯安全指南,LLM 智能分析(默认禁用,优先本地执行)

下载
  • spy:适合验证“真实调用是否发生 + 参数 + 次数”,但可能引发副作用(如网络请求、磁盘 IO)
  • patch:适合纯行为验证,隔离性强,call_count 更稳定
  • 对类方法 spy 时,注意是 spy 实例方法还是类方法——mocker.spy(MyClass, 'method') 监听所有实例,mocker.spy(obj, 'method') 只监听该实例

assert_called() 系列方法和 call_count 怎么配合用

call_count 是数值,灵活但需手动比对;assert_called_once()、assert_called_with() 这些是断言快捷方式,语义明确但覆盖场景有限。实际中建议优先用 call_count 做基础校验,再用 call_args_list 查具体参数。

容易踩的坑是混淆 assert_called_once() 和 assert_called_once_with(...):前者只检查次数为 1,后者还校验最后一次调用的参数——如果调用 2 次但只有最后一次参数匹配,后者会失败,而前者不会报错。

  • 查是否调用 ≥1 次:assert mock.call_count > 0
  • 查是否恰好 3 次:assert mock.call_count == 3
  • 查每次调用的参数:mock.call_args_list[0] == call('a')(需先 from unittest.mock import call)
  • 避免过度依赖 assert_called_once_with(),它不反映调用历史全貌

为什么有时候 call_count 始终是 0

最常见原因是 patch 路径写错了——不是目标函数当前被导入的位置,而是它“被使用的位置”。比如 utils.py 定义了 send_email(),但测试的是 service.py 里导入并调用它的代码,那就要 patch service.send_email,而不是 utils.send_email。

另一个隐蔽问题是 patch 作用域太窄:比如在 fixture 里 patch,但没 return mock 对象,或测试函数没接收该 fixture;或者用了 autouse=True fixture 却忘了在测试函数签名里声明依赖。

  • 用 print(mock._mock_name) 或 mock.called 快速确认 mock 是否被触达
  • 临时加 mock.side_effect = lambda *a, **k: print("called!") 看是否真进来了
  • 对模块级函数,优先 patch “测试文件里 import 的那个名字”,不是定义处
实际调试时,别只盯着 call_count 是否非零,先确认 mock 对象本身有没有被传进去、有没有被正确引用——很多“调用没被统计”的问题,根源是 mock 根本没生效。

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

相关专题

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

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

2023.07.20

1651

4

python能做什么
python能做什么

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

2023.07.25

4064

7

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

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

2023.07.31

1649

3

python教程
python教程

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

2023.08.03

23437

23

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

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

2023.08.04

2867

5

python eval
python eval

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

2023.08.04

2907

5

scratch和python区别
scratch和python区别

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

2023.08.11

1143

5

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

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

2023.08.10

596

4

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

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

2023.08.11

2263

5

热门下载

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

精品课程

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