如何在JUnit 5 @ParameterizedTest中用@TempDir生成独立临时目录

错误原因分析 #

你遇到的ParameterResolutionException是因为：

• 参数化测试的ParameterizedTestParameterResolver会尝试解析方法的所有参数，而TempDirectoryResolver会解析带有@TempDir注解的Path参数
• 原代码中@TempDir标记的Path参数排在最前面，两个解析器都能处理该参数，导致冲突

解决方案 #

方案1：调整@TempDir参数位置（推荐）

将@TempDir标记的参数移到参数化参数的后面，让两个解析器各司其职：

class MyTestClass {

    static Stream<Arguments> syntax() {
        return Stream.of(
            Arguments.of("grammars/Simple.g4", "expr"),
            Arguments.of("grammars/Arithmetic.g4", "prog")
        );
    }

    @ParameterizedTest
    @MethodSource("syntax")
    void checksSyntax(final String name, final String rule, @TempDir final Path temp) {     
        // 每个测试用例会自动获得独立的临时目录
        // 测试逻辑代码
    }
}

原理：

• 前两个String参数由参数化测试解析器处理，对应@MethodSource返回的测试数据
• 第三个带@TempDir的Path参数由临时目录解析器处理，每个参数化用例执行时都会生成全新的临时目录

方案2：实例字段+PER_METHOD生命周期

如果更习惯用字段存储临时目录，可以修改测试类的实例生命周期，确保每个用例对应独立的类实例：

@TestInstance(TestInstance.Lifecycle.PER_METHOD)
class MyTestClass {

    @TempDir
    private Path temp;

    static Stream<Arguments> syntax() {
        return Stream.of(
            Arguments.of("grammars/Simple.g4", "expr"),
            Arguments.of("grammars/Arithmetic.g4", "prog")
        );
    }

    @ParameterizedTest
    @MethodSource("syntax")
    void checksSyntax(final String name, final String rule) {     
        // 直接使用this.temp，每个用例对应独立实例的临时目录
        // 测试逻辑代码
    }
}

原理：

• 默认JUnit 5测试类采用PER_CLASS生命周期，所有用例共享一个实例
• 加上@TestInstance(TestInstance.Lifecycle.PER_METHOD)后，每个参数化用例会创建新的测试类实例，每个实例的@TempDir字段都会被初始化独立的临时目录

为什么之前的尝试无效 #

在@MethodSource方法中添加@TempDir参数时，该方法只会被调用一次（生成所有测试参数），因此所有测试用例都会复用同一个临时目录，无法实现隔离需求。

内容的提问来源于stack exchange，提问作者Volodya Lombrozo