Java参数化测试的核心目标是用一套测试逻辑驱动多组输入和预期结果自动执行，避免重复编写@Test方法；它通过@ParameterizedTest与@ValueSource、@CsvSource、@MethodSource等数据源注解实现单个方法多轮执行，将数据与逻辑分离，提升可维护性与覆盖率。
Java 参数化测试的核心目标，就是用一套测试逻辑，驱动多组输入和预期结果自动执行，避免为每组数据写一个重复的@Test方法。它不是“批量跑多个方法”，而是“单个方法，多轮执行”。关键在于把数据和逻辑分开，让框架帮你循环调用。
用 @ParameterizedTest + 数据源注解（JUnit 5 推荐）
这是目前最简洁、扩展性最强的方式，取代了 JUnit 4 的 @RunWith(Parameterized.class)。
-
@ValueSource：适合单一类型数据，比如只测几个字符串或数字
例如验证非空判断：@ParameterizedTest @ValueSource(strings = {"abc", "123", "x"}) void shouldNotBeEmpty(String input) { assertFalse(input.isEmpty()); } -
@CsvSource：最常用，支持多字段组合（输入+期望输出），每行一组测试数据
例如加法验证：@ParameterizedTest @CsvSource({"1, 2, 3", "0, 0, 0", "-5, 5, 0"}) void addReturnsCorrectSum(int a, int b, int expected) { assertEquals(expected, Calculator.add(a, b)); } -
@MethodSource：适合复杂对象、动态生成或复用已有数据集合
需定义静态方法返回Stream，例如：static Stream，再在测试上写provideUserCases() { return Stream.of(Arguments.of("admin", "123456", true), Arguments.of("guest", "", false)); } @MethodSource("provideUserCases")
从外部文件读取数据（CSV/Excel）
当测试数据量大、需业务人员维护，或要覆盖大量边界值时，硬编码在代码里不现实。JUnit 5 支持：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
@CsvFileSource：直接读取 classpath 下的 CSV 文件，每行映射为一次调用
文件add_cases.csv内容：1,2,310,20,30
测试中写：@CsvFileSource(resources = "/add_cases.csv") - Excel 需配合 Apache POI 自定义数据源（用 @MethodSource 封装读取逻辑），适合含格式、多 sheet 的测试用例管理
结合断言做批量结果验证
参数化本身不改变断言方式，但要注意：每组数据是独立执行、独立失败的。推荐做法是：
- 每个测试方法只聚焦一个被测行为（如只测 add，不混入 subtract）
- 断言用
assertEquals(expected, actual)明确比对，失败时报告会自动显示哪组数据出错（如 “addReturnsCorrectSum([1, 2, 3])”） - 若需校验集合类返回（如 List
），可用 assertIterableEquals(expectedList, actualList)，确保顺序和内容都一致
实际验证场景示例：接口入参校验
比如测试一个用户注册方法 register(User user)，需验证手机号、密码等字段在各种组合下的合法性：
- 准备多组 User 对象数据（用 @MethodSource 返回）：含正常手机号+强密码、空手机号、超长密码、特殊字符密码等
- 测试方法内调用
register(user)，捕获抛出的IllegalArgumentException或检查返回码 - 每组数据独立验证——某组手机号为空失败，不影响其他组执行，报告清晰可定位
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
