本文详解如何在 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.any()（推荐）或其别名 Mockito.any(Class)：

// 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.any() 替代裸 any()；它既保持类型安全，又兼容 Java 泛型机制，是编写健壮、可维护 Mockito 测试的关键实践。