本文详解如何在 Mockito 中准确指定 String[] 数组和 String... 可变参数的匹配器，避免因泛用 any() 导致的误匹配或测试脆弱性。
本文详解如何在 mockito 中准确指定 `string[]` 数组和 `string...` 可变参数的匹配器，避免因泛用 `any()` 导致的误匹配或测试脆弱性。
在使用 Mockito 进行单元测试时，若目标方法包含数组（如 String[]）或可变参数（String...），直接使用 Mockito.any() 会因类型擦除而失去编译期类型安全，甚至引发 InvalidUseOfMatchersException 或匹配不精准的问题。例如，以下方法签名：
void myMethod(QName param1, String[] param2, String... param3);
虽然 String... 在字节码层面等价于 String[]，但 Mockito 的匹配器需显式声明泛型类型以确保类型一致性——尤其当重载方法存在或需区分不同数组维度时。
✅ 正确做法是使用带泛型限定的 ArgumentMatchers.
// Stubbing（打桩）
when(myMock.myMethod(
any(QName.class),
ArgumentMatchers.<String[]>any(), // 明确匹配 String[] 类型
ArgumentMatchers.<String[]>any() // 同样匹配 String...（运行时即 String[]）
)).thenReturn(someOtherMock);
// Verification（验证）
verify(myMock).myMethod(
any(QName.class),
ArgumentMatchers.<String[]>any(),
ArgumentMatchers.<String[]>any()
);⚠️ 注意事项：
- 不要写成 any(String[].class) —— 虽然语法合法，但 any(Class
) 在 Mockito 4+ 中已标记为过时（deprecated），官方推荐统一使用 ArgumentMatchers. any() 以获得更好的类型推导和 IDE 支持； - ArgumentMatchers.anyString() 或 anyList() 等专用匹配器不适用于数组/可变参数场景，它们匹配的是单个 String 或 List 实例，而非 String[]；
- 若需更严格的断言（如校验数组内容），应改用 argThat(ArgumentMatcher
)，例如： argThat(arr -> arr != null && Arrays.asList(arr).contains("expectedValue"))
? 小结：对 String[] 和 String... 参数，始终使用 ArgumentMatchers.
