使用 @parameterizedtest 需要引入 junit jupiter 的参数化测试依赖，并在测试方法上添加该注解及具体的来源注解（如 @valuesource、@csvsource 或 @methodsource）来提供输入数据。这样可以将同一逻辑的多次不同输入测试合并到一个方法中，junit 会自动为每组参数执行一次测试并生成独立的报告条目。
如何为简单类型提供固定输入值
对于字符串、数字等基础类型，直接使用 @ValueSource 是最便捷的方式。它允许在注解中直接定义一个数组作为参数源，测试框架会将数组中的每个元素依次注入到测试方法的参数中。这种方式适合数据量小且静态固定的场景，代码简洁且无需额外配置。
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
class StringValidationTest {
@ParameterizedTest(name = "验证输入 "{0}" 是否包含字母")
@ValueSource(strings = {"abc", "Hello", "123", "Test"})
void testContainsLetter(String input) {
boolean result = input.chars().anyMatch(Character::isLetter);
Assertions.assertTrue(result,
() -> "输入 '" + input + "' 应包含至少一个字母");
}
}
上述代码定义了四个字符串输入："abc"、"Hello"、"123" 和 "Test"。运行后，testContainsLetter 方法会被调用四次。前三个输入包含字母，断言通过；第四个输入 "123" 不包含字母，断言失败并抛出异常，报告中会显示该次执行的错误信息。这种机制确保了每个输入都经过独立验证，且失败时能精确定位到具体是哪个参数导致了问题。
如何处理多参数或复杂结构化数据
当测试逻辑涉及多个参数，或者数据格式较为复杂时，@CsvSource 提供了更灵活的解决方案。它支持以逗号分隔的多列数据，自动将每行数据映射到测试方法的多个参数上。这种方法特别适合边界值测试、组合条件测试或模拟数据库记录的场景，能够清晰地在代码中展示输入与预期的对应关系。
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
class ArithmeticOperationTest {
@ParameterizedTest
@CsvSource({
"10, 5, 15",
"0, 0, 0",
"-5, 5, 0",
"100, -10, 90"
})
void testAddition(int a, int b, int expected) {
int result = a + b;
Assertions.assertEquals(expected, result,
() -> "计算 " + a + " + " + b + " 结果错误");
}
}
该测试用例通过 @CsvSource 提供了四组整数对及其预期和。第一组 10, 5, 15 表示输入 a=10, b=5，期望结果为 15。测试方法接收这三个参数并执行加法运算。如果实际结果与 expected 不匹配，断言失败并输出自定义消息。这种结构化的数据呈现方式使得测试意图一目了然，同时也便于后续维护和数据扩展。
基于程序返回值的空指针异常处理问题
在使用参数化测试时，若输入数据包含 null 值，需特别注意目标代码是否具备空值处理能力。例如，当测试方法内部直接调用 String.length() 且未进行 null 检查时，传入 null 参数将导致 NullPointerException。此时，测试本身会因未捕获的异常而失败，这符合预期行为，但建议在测试前明确业务逻辑对 null 的定义，或在代码中加入防御性判断。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
