JUnit5的@ParameterizedTest要求数据源返回的具体类型必须与测试方法形参的通配符泛型兼容：如List<? extends Number>需传List<Integer>等具体子类型，禁用原始类型，推荐使用@MethodSource确保编译期类型安全。
JUnit5 的 @ParameterizedTest 本身不关心泛型擦除问题，它只负责把参数“传进去”；真正关键的是：你提供的数据源（比如 @MethodSource 返回的 Stream）必须与测试方法签名中的形参类型**在编译期和运行时都兼容**。而带通配符的泛型（如 List<? extends Number>、Collection<?>）容易因类型推导失败或原始类型误用导致编译错误或 ClassCastException。
确保数据源返回的具体类型能被安全赋值给通配符形参
Java 泛型是编译期特性，通配符（?、? extends T、? super T）表示“未知但受限的类型”。JUnit5 在调用测试方法前会做类型匹配——它不会帮你做泛型转换，而是依赖 Java 方法调用的类型兼容规则。
- 如果测试方法形参是
List<? extends Number>，那么数据源应返回List<Integer>、List<Double>等具体子类型实例，不能返回裸类型List或List<Object> - 避免使用原始类型（raw type），例如
List—— 这会导致编译警告，且可能在运行时因类型擦除引发ClassCastException -
@MethodSource方法必须声明明确的返回类型（如Stream<Arguments>），且每个Arguments.of(...)中的参数顺序和类型要严格匹配测试方法签名
用 Arguments.of() 传递通配符泛型对象时，显式构造具体泛型实例
不要试图传入 new ArrayList<>() 并期望 JUnit 自动适配成 List<?>；而是直接创建符合边界的实例：
- ✅ 正确：
Arguments.of(Arrays.asList(1, 2, 3))→ 可匹配List<? extends Number>（因为Integer是Number子类） - ✅ 正确：
Arguments.of(new ArrayList<String>())→ 可匹配Collection<?>或List<?> - ❌ 错误：
Arguments.of(new ArrayList())（原始类型）→ 编译通过但不安全，运行时可能出问题 - ❌ 错误：
Arguments.of((List<?>) new ArrayList<String>())→ 强制转型无意义，且可能掩盖类型不匹配
配合 @MethodSource 时，返回 Stream<Arguments> 并保持类型透明
数据提供方法需明确返回类型，让编译器和 IDE 能校验参数一致性：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
private static Stream<Arguments> provideLists() {
return Stream.of(
Arguments.of(Arrays.asList("a", "b")), // → List<String>
Arguments.of(Arrays.asList(1.0, 2.5)), // → List<Double>
Arguments.of(new LinkedList<Integer>(Arrays.asList(10, 20)))
);
}
对应测试方法：
@ParameterizedTest
@MethodSource("provideLists")
void testWithWildcard(List<?> list) { // ✅ 接收任意 List 实例
assertThat(list).isNotEmpty();
}
@ParameterizedTest
@MethodSource("provideLists")
void testWithBoundedWildcard(List<? extends CharSequence> list) {
// ✅ 上例中 List<String> 满足，List<Double> 不满足 → 编译报错！
// 所以数据源必须统一满足边界，或拆分成不同 source 方法
}
注意：若形参是 List<? extends CharSequence>，则数据源中所有 List 必须元素类型是 CharSequence 子类（如 String、StringBuilder），否则编译失败。
慎用 @CsvSource 或 @ValueSource 处理泛型集合
这些注解只支持基本类型、字符串及可自动转换的类型（如 int、String、LocalDate），无法直接生成 List<?>。若坚持用，需自定义 ArgumentConverter，但易引入类型不安全操作：
- 不推荐：用
@CsvSource({"1,2,3", "a,b,c"})+ 自定义 converter 解析为List<?>—— converter 返回类型难精确表达，易丢失泛型信息 - 推荐：优先用
@MethodSource，类型可控、调试友好、IDE 支持好
