在使用 Mockito 模拟泛型方法时，无法通过 any() 或类型擦除后的 TypeReference 直接区分不同泛型实参；正确做法是使用 thenAnswer 获取实际传入的 TypeReference 实例，并通过其 getType() 反射解析真实类型，实现按泛型签名精准返回不同值。
在使用 mockito 模拟泛型方法时，无法通过 `any()` 或类型擦除后的 `typereference` 直接区分不同泛型实参；正确做法是使用 `thenanswer` 获取实际传入的 `typereference` 实例，并通过其 `gettype()` 反射解析真实类型，实现按泛型签名精准返回不同值。
在 Java 单元测试中，当被测方法接收 TypeReference
解决此问题的核心思路是：放弃静态类型匹配，改用动态参数检查。thenAnswer(InvocationOnMock) 允许你在每次方法调用时获取真实的参数对象，进而通过反射分析 TypeReference.getType() 所封装的 java.lang.reflect.Type，精确比对泛型签名。
以下是一个可直接复用的完整示例：
@Test
void testGetConfigurationWithDifferentTypeReferences() {
// 假设 mapper 是被 mock 的 ObjectMapper 实例
ObjectMapper mapper = mock(ObjectMapper.class);
// 使用 thenAnswer 实现类型感知的返回逻辑
when(mapper.readValue(eq(SDK_BYTES), any(TypeReference.class)))
.thenAnswer(invocation -> {
TypeReference<?> typeRef = invocation.getArgument(1);
Type actualType = typeRef.getType();
// 推荐：使用 TypeUtils（来自 commons-lang3）或手动字符串匹配（注意健壮性）
String typeName = actualType.getTypeName();
if (typeName.equals("java.util.Map<java.lang.String, java.util.List<java.lang.String>>")) {
return Map.of("key", List.of("a")); // 对应 TypeReference<Map<String, List<String>>>
} else if (typeName.equals("java.util.Map<java.lang.String, com.example.FeatureLaunchStatus>")) {
return Map.of("flag", new FeatureLaunchStatus(true)); // 对应 TypeReference<Map<String, FeatureLaunchStatus>>
} else {
throw new IllegalArgumentException("Unsupported type: " + typeName);
}
});
// 测试调用
TypeReference<Map<String, List<String>>> listMapRef =
new TypeReference<Map<String, List<String>>>() {};
Map<String, List<String>> result1 = mapper.readValue(SDK_BYTES, listMapRef);
assertThat(result1).containsEntry("key", List.of("a"));
TypeReference<Map<String, FeatureLaunchStatus>> statusMapRef =
new TypeReference<Map<String, FeatureLaunchStatus>>() {};
Map<String, FeatureLaunchStatus> result2 = mapper.readValue(SDK_BYTES, statusMapRef);
assertThat(result2).containsEntry("flag", new FeatureLaunchStatus(true));
}⚠️ 注意事项与最佳实践：
- 避免硬编码 typeName 字符串：生产环境建议引入 org.apache.commons.lang3.reflect.TypeUtils 进行类型等价性判断（如 TypeUtils.equals(type1, type2)），或封装 TypeReference 匹配器工具类；
- 匿名子类是关键：new TypeReference<...>() {} 创建了带具体泛型信息的子类实例，getType() 才能正确返回带泛型的 ParameterizedType，普通 new TypeReference<...>()（无 {}）将丢失类型信息；
- 警惕过度模拟：若 TypeReference 分支较多或逻辑复杂，应考虑替换为轻量 Fake 实现（如继承自真实类并重写核心方法），提升可读性与可维护性；
-
不要滥用 any() 配合泛型强制转换：Mockito.
any() 仅影响编译期类型推导，不改变运行时行为，无法解决本问题。
综上，thenAnswer + invocation.getArgument() 是处理泛型敏感 mock 的标准解法。它绕过了类型擦除限制，将类型决策权交还给测试逻辑本身，既保持了灵活性，又确保了类型安全性。
