本文介绍如何使用 Python 的 unittest.mock（或 pytest-mock）精确验证被测函数被多次调用时每次传入的不同参数，重点利用 call_args_list、assert_has_calls() 和 call() 辅助函数实现细粒度断言。
本文介绍如何使用 python 的 `unittest.mock`（或 `pytest-mock`）精确验证被测函数被多次调用时每次传入的不同参数，重点利用 `call_args_list`、`assert_has_calls()` 和 `call()` 辅助函数实现细粒度断言。
在单元测试中，当被测代码对同一函数（如数据库持久化函数 database_persist）发起多次调用，且每次传入的参数组合各不相同时，仅使用 assert_called_with() 无法满足断言需求——它默认只校验最后一次调用。此时需借助 mock 对象提供的调用历史机制进行精准验证。
核心方法是访问 mock.call_args_list 属性，它返回一个 list，其中每个元素是一个 call 对象，代表一次调用的完整签名（含位置参数与关键字参数）。为提升可读性与健壮性，推荐使用 mock.assert_has_calls() 配合 unittest.mock.call() 构造预期调用序列：
from unittest.mock import patch, call
def test_database_persist_called_twice_with_different_args():
with patch("admin.bootstrap.grouping.database_persist") as mock_db_persist:
# 触发被测逻辑（例如执行业务流程）
function_caller_database_persist() # 内部两次调用 database_persist
# ✅ 断言两次调用的完整参数序列（顺序敏感）
expected_calls = [
call(1, 2, 3, 4), # 第一次调用
call(5, 6, 7, 8), # 第二次调用
]
mock_db_persist.assert_has_calls(expected_calls)
# ✅ 可选：单独验证某次调用（如第一次）
assert mock_db_persist.call_args_list[0] == call(1, 2, 3, 4)
# ✅ 或验证最后一次调用
assert mock_db_persist.call_args == call(5, 6, 7, 8)⚠️ 注意事项：
-
assert_has_calls()默认严格校验调用顺序和完整性。若只需验证“至少发生过这些调用”（不关心顺序或中间是否有其他调用），可传入any_order=True参数； -
call_args_list中的call对象支持解包比较，但直接用==比较元组（如mock.call_args_list[0][0] == (1,2,3,4)）不可靠，因其内部结构包含args和kwargs字段，应始终使用call(...)构造器进行比对； - 若函数含
**kwargs，需在call()中显式写出关键字参数，例如call(session=1, something=2, date=3, all_data=4, extra="val")； - 在
pytest环境中，使用mocker.patch时语法一致，仅需将with patch(...)替换为mocker.patch(...)并注入 fixture 即可。
总结：通过 call_args_list 获取调用快照，结合 assert_has_calls() 与 call() 工厂函数，即可清晰、可靠、可维护地完成多参数调用的逐次断言，这是编写高质量交互式单元测试的关键实践。
