@TestFactory用于动态生成测试用例，返回Stream<DynamicTest>，支持单输入、参数组合及外部数据（如CSV）加载，每个DynamicTest独立执行且需明确displayName与executable逻辑。
JUnit5 的 @TestFactory 用于在运行时动态生成多个测试用例，适用于测试数据来自外部（如文件、数据库、配置）或需组合多种输入参数的场景。它不直接执行测试，而是返回一个 Stream<DynamicTest>，每个 DynamicTest 是一个独立可执行的测试实例。
基本用法：用 DynamicTest.of()
最简方式是手动构造单个或多个 DynamicTest，通过 DynamicTest.dynamicTest(String displayName, Executable executable) 创建：
@TestFactory
Stream<DynamicTest> testWithSingleInput() {
return Stream.of("hello", "world")
.map(input -> DynamicTest.dynamicTest(
"test with input: " + input,
() -> assertEquals(input.toUpperCase(), input.toUpperCase())
));
}
注意：displayName 会显示在 IDE 或报告中，建议具名且可读；executable 是实际执行的逻辑，必须是无参 lambda（不能抛受检异常，否则需包装）。
支持参数化组合：用 DynamicTest.stream()
当需要两组数据交叉组合（如多个输入 × 多个期望值），可用 DynamicTest.stream(Iterator, Function) 或更直观的 DynamicTest.stream(Supplier<Stream<T>>, Function<T, DynamicTest>)：
立即学习“Java免费学习笔记（深入）”；
@TestFactory
Stream<DynamicTest> testCartesianProduct() {
List<String> inputs = Arrays.asList("a", "b");
List<Integer> expectedLengths = Arrays.asList(1, 2);
return DynamicTest.stream(
() -> inputs.stream().flatMap(i -> expectedLengths.stream().map(j -> new Object[]{i, j})),
obj -> {
String input = (String) obj[0];
Integer expected = (Integer) obj[1];
return DynamicTest.dynamicTest(
String.format("length('%s') == %d", input, expected),
() -> assertEquals(expected, input.length())
);
}
);
}
加载外部数据：从 CSV 或 JSON 构建测试
常见需求是从文件读取测试用例。例如读取 CSV 行并逐行生成测试（推荐配合 Files.lines() 和 try-with-resources）：
- 确保 CSV 文件路径正确，推荐放在
src/test/resources下 - 每行解析为数组或自定义对象，避免在
@TestFactory方法内做复杂 IO（可提前加载并缓存） - 对空行、注释行做跳过处理，提升健壮性
- 失败时的错误信息应包含当前用例标识（如第几行、输入值），便于定位
示例片段（简化版）：
@TestFactory
Stream<DynamicTest> testFromCsv() throws IOException {
Path path = Paths.get("src/test/resources/test-data.csv");
return Files.lines(path)
.filter(line -> !line.trim().startsWith("#") && !line.trim().isEmpty())
.map(line -> line.split(","))
.map(parts -> DynamicTest.dynamicTest(
"parse: " + parts[0],
() -> assertTrue(Boolean.parseBoolean(parts[1]))
));
}
注意事项与限制
-
@TestFactory方法必须返回Stream<DynamicTest>、Collection<DynamicTest>或数组，不能是 void 或其他类型 - 每个
DynamicTest独立执行，失败互不影响；但工厂方法本身抛异常会导致整个测试跳过 - 不支持
@BeforeEach/@AfterEach直接作用于单个动态测试（可通过DynamicTest.dynamicTest(String, Executable)内部手动模拟） - IDE 支持良好（IntelliJ/VS Code），但部分旧插件可能无法展开嵌套层级，建议保持 display name 清晰
