JUnit 5 参数化测试：利用集合变量驱动多维度的测试用例执行

JUnit 5 的参数化测试，允许你直接用集合变量（比如 List、Stream、Arguments 这些）来驱动测试逻辑自动执行多组数据。这里有两个关键点：一是选对注解，二是把集合里的每一组数据正确转换成可注入的参数组合。搞懂了这两点，参数化测试才能真正发挥威力。

用 @MethodSource 绑定自定义集合

这可以说是最灵活、最推荐的做法了，特别是当数据需要动态生成、类型复杂，或者需要复用时，它的优势非常明显。

• 被标注的方法必须是 static 的，返回类型可以是 Stream 或 Iterable。
• 通过 Arguments.of(...) 把集合中的一组值打包成一个参数元组，顺序必须和测试方法的形参严格对应。
• 举个例子：如果测试方法需要用户 ID、姓名、是否激活三个字段，那就写 Arguments.of(101, "张三", true)。

@CsvSource 和 @ValueSource：本质也是集合，但写死在注解里

这两种注解底层其实也是被解析为 Collection 的，只不过语法更轻量，适合处理简单、少量、结构清晰的测试数据。

• @ValueSource(strings = {"a", "b", "c"}) 适用于单参数场景，集合元素直接一一映射到测试参数。
• @CsvSource({"1, admin", "2, guest", "3, null"}) 适用于多参数场景，每行 CSV 数据就是一个集合子项，按逗号拆分成参数列表。
• 需要注意：空格、引号、换行等特殊情况需要显式处理，不太适合含逗号或换行的原始文本。

集合变量来自外部文件：@CsvFileSource 或自定义 ArgumentsProvider

当数据量大、需要业务人员维护，或者数据频繁变更时，把数据硬编码在代码里就不太合适了，应该考虑从外部文件加载。

• @CsvFileSource(resources = "/test-data/users.csv") 可以直接读取 classpath 下的 CSV 文件，每行转为一组参数。
• 自定义 ArgumentsProvider 实现能够读取 Excel、YAML、数据库甚至远程 API 返回的集合数据，完全可控。
• 举个实际场景：把 50 条登录用例存进 login_cases.yaml，测试时按需加载为 Stream，非常灵活。

两个容易踩的坑，千万要避开

不是所有集合都能直接驱动参数化测试，结构错位会导致编译失败或运行时报 ArgumentMismatchException。

• ❌ 错误：在 @ParameterizedTest 方法里声明 List inputs 形参 —— JUnit 不支持“集合整体入参”这种方式。
• ❌ 错误：用 @MethodSource 返回 Stream，但测试方法的形参却是 String name, int age —— 类型和数量都不匹配。
• ✅ 正确做法：集合元素必须是 Arguments，每个 Arguments 包含的值必须与方法形参一一对应。