本文详解如何在 Mockito 中为含泛型数组（String[]）和可变参数（String...）的方法，编写类型安全、语义明确的 when() 和 verify() 断言，避免因过度宽泛的 any() 导致误匹配。

本文详解如何在 mockito 中为含泛型数组（`string[]`）和可变参数（`string...`）的方法，编写类型安全、语义明确的 `when()` 和 `verify()` 断言，避免因过度宽泛的 `any()` 导致误匹配。

在使用 Mockito 进行单元测试时，当被测方法签名包含泛型化数组（如 String[]）或可变参数（String...）时，直接调用 Mockito.any() 会丢失类型信息——因为 any() 默认返回 Object 类型，编译器无法推断其应为 String[]，可能导致运行时 InvalidUseOfMatchersException，或更隐蔽的匹配失效问题（例如误匹配其他数组类型）。

正确做法是显式指定泛型类型参数，使用 ArgumentMatchers.any()（推荐）或其简写形式 any(T.class)（自 Mockito 3.4.0+ 起支持）。对于你的方法：

myMethod(QName param1, String[] param2, String... param3)

其中 param2 是 String[]，而 param3 在字节码层面也表现为 String[]（Java 可变参数本质即数组），因此二者均需精确声明为 String[] 类型。

✅ 推荐写法（类型安全、兼容性好）：

import static org.mockito.ArgumentMatchers.*;

// stubbing
when(myMock.myMethod(
    any(QName.class),
    any(String[].class),      // ✅ 明确匹配 String[] 类型（param2）
    any(String[].class)       // ✅ 明确匹配 String[] 类型（param3，即 ...）
)).thenReturn(someOtherMock);

// verifying
verify(myMock).myMethod(
    any(QName.class),
    any(String[].class),
    any(String[].class)
);

⚠️ 注意事项：

• 不要使用 any() 或 anyObject() 替代——它们不携带泛型信息，可能匹配任意对象，降低测试可靠性；
• ArgumentMatchers.any() 在旧版 Mockito（
• 若需进一步约束数组内容（如要求非空、含特定元素），应改用 argThat() 配合自定义 ArgumentMatcher，例如：

  argThat(arr -> arr != null && arr.length > 0 && "expected".equals(arr[0]))

? 小结：Mockito 的类型匹配依赖编译期泛型推断。对数组和可变参数，务必使用 any(Class) 显式声明目标类型，既提升代码可读性，又确保 stub/verify 行为精准可靠——这是编写健壮 Mock 测试的关键实践之一。