如何在JUnit 5的测试类外部创建临时目录？

我完全懂你对JUnit 5 @TempDir特性的喜爱——只需要在测试类里写一行@TempDir private Path tempPath;，JUnit就自动帮你搞定临时目录的创建、使用后的清理，简直是测试里的小神器！

但你踩的这个坑确实是官方设计的预期行为——@TempDir注解原本就只支持在测试类的字段或者测试方法参数上使用，在自定义扩展类里直接标注的话，JUnit不会去处理这个注解，变量自然一直是null，相关的GitHub工单也明确标注了“符合预期设计”，所以这条路走不通。

不过你提到的两个方向都是可行的，下面给你详细拆解用法：

方案一：直接使用TempDirectory API（最推荐） #

JUnit 5的org.junit.jupiter.api.io.TempDirectory类就是@TempDir注解背后的底层实现，你可以在自定义扩展里直接调用它的API来创建和管理临时目录，完全复用JUnit的生命周期管理逻辑。

比如在你的BeforeAllCallback扩展里：

import org.junit.jupiter.api.io.TempDirectory;
import org.junit.jupiter.api.extension.BeforeAllCallback;
import org.junit.jupiter.api.extension.ExtensionContext;
import java.nio.file.Path;

public class CustomTempBackupExtension implements BeforeAllCallback {
    @Override
    public void beforeAll(ExtensionContext context) throws Exception {
        // 创建临时目录，可指定前缀/后缀，这里用测试类名称作为前缀
        Path tempDir = TempDirectory.createTempDirectory(context.getDisplayName());
        
        // 在这里执行你的文件备份逻辑，比如把本地文件复制到临时目录
        // backupLocalFilesToTempDir(tempDir);
        
        // 将临时目录存入ExtensionContext的存储区，方便后续测试或扩展步骤获取
        context.getStore(ExtensionContext.Namespace.create(getClass()))
               .put("BACKUP_TEMP_DIR", tempDir);
        
        // 注册自动清理回调，测试结束后JUnit会自动删除这个临时目录
        context.registerExtension(new TempDirectory.CloseableResource(tempDir));
    }
}

这个方案的好处是：

• 完全复用JUnit的临时目录管理逻辑，不用自己写删除/清理代码
• 支持和JUnit的生命周期联动，确保临时目录在测试结束后被清理
• 不需要额外依赖，TempDirectory是junit-jupiter-api自带的类

方案二：用AnnotationSupport处理注解（适合扩展注解逻辑） #

如果你的扩展需要和测试类中的@TempDir注解交互（比如自定义注解逻辑，或者提前初始化测试类的@TempDir字段），可以用org.junit.jupiter.api.extension.support.AnnotationSupport来扫描和处理注解。不过这个方案更适合复杂场景，你的需求用方案一就足够了，这里给个示例供参考：

import org.junit.jupiter.api.extension.support.AnnotationSupport;
import org.junit.jupiter.api.io.TempDir;
import org.junit.jupiter.api.extension.BeforeAllCallback;
import org.junit.jupiter.api.extension.ExtensionContext;
import java.lang.reflect.Field;
import java.nio.file.Path;

public class CustomTempDirExtension implements BeforeAllCallback {
    @Override
    public void beforeAll(ExtensionContext context) throws Exception {
        // 扫描测试类中标记了@TempDir的字段
        Field tempDirField = AnnotationSupport.findAnnotatedFields(
                context.getRequiredTestClass(), TempDir.class
        ).stream().findFirst()
         .orElseThrow(() -> new IllegalStateException("测试类中未找到@TempDir字段"));
        
        // 自定义初始化临时目录（其实JUnit会自动处理，这里仅作示例）
        Path tempDir = TempDirectory.createTempDirectory("custom-prefix");
        tempDirField.setAccessible(true);
        tempDirField.set(context.getRequiredTestInstance(), tempDir);
        
        // 同样注册清理回调
        context.registerExtension(new TempDirectory.CloseableResource(tempDir));
    }
}

额外说明 #

不需要引入额外的Maven包，上述所有类都是JUnit Jupiter API（junit-jupiter-api依赖）自带的，只要你的JUnit版本在5.7.0及以上就可以直接使用。

总结一下：优先选择方案一，它最贴合你的需求，代码简洁还能复用JUnit的原生逻辑，完美解决你在扩展中创建临时目录并备份文件的需求。

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