JUnit 5 中 @TempDir 注解用于字段时出现 NullPointerException，根本原因在于 Maven 缺少 maven-surefire-plugin（或 maven-failsafe-plugin）显式配置，导致 JUnit Platform 启动器未被激活，@TempDir 扩展无法执行注入。
junit 5 中 `@tempdir` 注解用于字段时出现 `nullpointerexception`，根本原因在于 maven 缺少 `maven-surefire-plugin`（或 `maven-failsafe-plugin`）显式配置，导致 junit platform 启动器未被激活，`@tempdir` 扩展无法执行注入。
在 JUnit 5 中，@TempDir 是一个功能强大的扩展注解，支持两种使用方式：作为测试方法参数（推荐）和作为测试类字段（需满足严格条件）。你遇到的问题——IntelliJ IDEA 中运行正常、Maven 命令行中却抛出 NullPointerException——是典型的 JUnit Platform 运行环境缺失现象，而非代码逻辑错误。
? 为什么字段级 @TempDir 在 Maven 下为 null？
JUnit 5 的扩展模型（Extension Model）依赖于 junit-platform-launcher 和配套的构建插件协同工作。当 @TempDir 标注在实例字段（如 private Path tempDir;）上时，其生命周期管理由 TempDirectoryExtension 负责，该扩展必须在测试执行前完成字段注入。而 Maven 默认仅通过 surefire 插件调用 junit-platform-launcher —— 若未显式声明 maven-surefire-plugin，Maven 可能回退到旧版 JVM 测试发现机制（如 JUnit 4 兼容模式），完全跳过 JUnit Jupiter 扩展链，导致 tempDir 字段始终为 null。
IntelliJ IDEA 能成功运行，是因为其内置测试运行器直接集成 JUnit Platform Launcher，无需依赖 Maven 插件即可加载所有扩展；而 mvn test 则严格依赖 surefire 的配置完整性。
✅ 正确修复方案：显式配置 Surefire 插件
在 pom.xml 的
<build><plugins><plugin><artifactid>maven-surefire-plugin</artifactid><version>3.2.5</version><!-- 推荐使用最新稳定版 --><configuration><!-- 强制启用 JUnit Platform --><includes><include>**/*Test.class</include></includes><!-- 可选：启用详细日志便于调试 --><argline>--add-opens java.base/java.lang=ALL-UNNAMED</argline></configuration></plugin></plugins></build>
? 关键点说明：
- maven-surefire-plugin 版本 必须 ≥ 3.0.0（你当前使用的是 5.9.2 的 JUnit，对应 Surefire 至少需 3.0.0）；
- 低版本（如 2.22.x）不支持 JUnit Jupiter 的扩展模型，即使声明了 junit-jupiter-engine 也无法触发 @TempDir 注入；
- 若项目含集成测试（*IT.java），还需同步配置 maven-failsafe-plugin（配置结构一致）。
?️ 进阶建议：字段 vs 参数？优先选择方法参数
虽然修复插件后字段注入可正常工作，但强烈建议改用方法参数形式，理由如下：
| 维度 | @TempDir 方法参数 | @TempDir 实例字段 |
|---|---|---|
| 隔离性 | ✅ 每个测试独享独立临时目录（自动创建/清理） | ⚠️ 若标注 static 则全局共享；非 static 时虽每测试新建，但生命周期管理更复杂 |
| 可读性 | ✅ 显式声明依赖，符合函数式设计思想 | ❌ 隐式注入，易忽略生命周期约束 |
| 兼容性 | ✅ 全环境（IDE/Maven/CI）100% 稳定 | ⚠️ 对插件、JVM 参数、IDE 设置更敏感 |
| 调试友好度 | ✅ 空指针直接暴露在测试方法签名，定位快 | ❌ NPE 发生在字段访问处，堆栈不直观 |
✅ 推荐写法（简洁、健壮、无歧义）：
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.io.TempDir;
import java.nio.file.Path;
class FileTest {
@Test
void testConstructor_FileDoesNotExist_ExpectIllegalArgumentException(@TempDir Path tempDir) {
Path nonExistingFile = tempDir.resolve("NonExistingFile.xls");
// 注意：Path.of() 不推荐用于动态路径拼接，应使用 resolve()
assert !nonExistingFile.toFile().exists();
}
}
⚠️ 其他常见陷阱排查清单
- JDK 版本不匹配：确保 maven-compiler-plugin 与 surefire 的 argLine 兼容（如 JDK 17+ 需 --add-opens）；
- 依赖冲突：检查是否意外引入 junit:junit:4.x（同名包污染 org.junit.*）；
- 测试类命名规范：Surefire 默认只扫描 *Test、Test*、*TestCase 类，确认类名符合约定；
- IDE 缓存问题：IntelliJ 中执行 File → Invalidate Caches and Restart，避免 IDE 与 Maven 配置不一致。
✅ 总结
@TempDir 字段为空的根本症结不在代码，而在 Maven 构建管道未接入 JUnit Platform。添加 maven-surefire-plugin 并升级至 3.0.0+ 是强制前提；在此基础上，优先采用方法参数形式，既规避环境差异风险，又提升测试可维护性与可移植性。真正的单元测试稳定性，始于构建配置的精确性。
