使用 unittest.mock.ANY 可以灵活断言 Mock 对象被调用时某些参数符合预期，而忽略其他未知或不重要的参数，避免手动遍历 mock_calls，提升测试简洁性与可维护性。
使用 `unittest.mock.any` 可以灵活断言 mock 对象被调用时某些参数符合预期，而忽略其他未知或不重要的参数，避免手动遍历 `mock_calls`，提升测试简洁性与可维护性。
在编写单元测试时，我们常需验证某个被 mock 的函数是否以特定参数被调用。但有时，仅部分参数是确定且关键的（例如固定输入值），其余参数可能是动态生成的（如 random.random()、时间戳、UUID 或回调函数等），无法预先断言其具体值。此时，硬编码完整参数列表会导致测试脆弱甚至失败。
Python 的 unittest.mock 模块为此提供了优雅的解决方案：ANY —— 一个特殊的占位符对象，其 __eq__ 方法始终返回 True，因此在 assert_called_with、assert_any_call 等断言中，它能匹配任意实际传入的值。
以下是一个典型示例：
import random
from unittest import mock
from unittest.mock import ANY
def mymethod(a, handler):
handler(a, random.random()) # 第二个参数是不确定的浮点数
def test_mymethod():
handler = mock.Mock()
mymethod(5, handler)
# ✅ 正确：只断言第一个参数为 5，第二个参数可为任意值
handler.assert_any_call(5, ANY)该断言会成功通过，因为 ANY 在比较时恒等于 random.random() 的实际返回值（如 0.732...）。
? 补充说明：
ANY不仅适用于assert_any_call，同样适用于assert_called_with、assert_has_calls和call_args的解包校验。例如：# 验证最后一次调用的第一个参数为 5 assert handler.call_args[0][0] == 5 # 或更安全地结合 ANY 进行结构化断言 handler.assert_called_with(5, ANY)
⚠️ 注意事项：
-
ANY是类型安全的“通配符”，不是字符串'ANY'或None，必须从unittest.mock显式导入； - 它仅影响
==比较逻辑，对is判断无效（ANY is not ANY）； - 若需更精细控制（如匹配某类值），可配合自定义匹配器（如
mock.ANY的扩展或side_effect回调校验），但绝大多数场景ANY已足够简洁可靠。
综上，ANY 是 unittest.mock 中专为“部分参数校验”设计的标准工具，应作为测试中处理动态/不可预测参数的首选方案。
