pytest中验证函数调用次数最稳妥的方式是使用mock.call_count进行数值比较，如assert mock_helper.call_count == 2；它统计进入mock函数体的次数，与返回值或异常无关，且不校验参数。
pytest里怎么断言某个函数被调用了几次
直接用 mock.assert_called() 或 mock.assert_called_once() 只能判断“是否调用过”或“是否只调用一次”，没法验证具体次数。真要断言调用次数，得靠 mock.call_count 手动比对，或者用 assert_called_with() 的变体配合多次记录。
用 mock.call_count 最稳妥也最常用
这是最直白、兼容性最好、且不会因参数差异误判的方式。只要你在测试中正确 patch 了目标函数（注意 patch 位置），就能直接读取计数：
from unittest.mock import patch
<p>def test_something_calls_helper_twice():
with patch("my_module.helper_func") as mock_helper:
do_something() # 内部调用 helper_func 两次
assert mock_helper.call_count == 2
- 必须确保
patch的路径准确——比如函数定义在utils.py，但在main.py中被导入使用，那就要 patch"main.utils.helper_func"，而不是"utils.helper_func" -
call_count是整数，可参与任意数值比较：>=、!= 0、== 3都行 - 它不关心参数，所以适合只关注“触发频次”的场景（比如重试逻辑、缓存穿透防护）
想同时验证调用次数和每次的参数？用 mock.call_args_list
当需要确认“不仅调用了 3 次，而且每次传的参数分别是 A、B、C”时，call_args_list 就派上用场了。它返回一个 list，每个元素是 call(…) 对象：
huaweicloud-python-sdk-helper
下载
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
assert len(mock_func.call_args_list) == 3
assert mock_func.call_args_list[0] == call("first")
assert mock_func.call_args_list[1] == call("second")
assert mock_func.call_args_list[2] == call("third")
- 别直接用
==比较整个call_args_list和[call(...), ...]——顺序敏感，且容易因默认参数展开导致不等 - 如果只关心某次调用的参数，用
mock_func.assert_called_with("expected_arg")，但它只检查最后一次调用 - 注意：
call_args_list是按调用顺序追加的，不是栈式结构
别踩 side_effect 和 return_value 混用的坑
如果你在 mock 上同时设置了 side_effect（比如抛异常或返回不同值）和 return_value，后者会被忽略——但 call_count 依然正常累加。这点容易让人误以为“没调用成功所以不该计数”，其实只要进了函数入口，就算一次。
立即学习“Python免费学习笔记（深入）”；
-
call_count统计的是“进入 mock 函数体”的次数，跟返回值或异常无关 - 若用
side_effect=[ValueError, 42]模拟第一次失败、第二次成功，call_count仍是 2 - 想验证“只执行到第一次就中断了”，不能只看
call_count == 1，还得结合异常捕获逻辑断言行为是否符合预期
真正难的不是写断言，而是确定该 patch 哪一层——调用链越深，patch 路径越容易错；而 call_count 看似简单，一旦 mock 失败，它永远是 0，你还以为逻辑没走到那儿。
