JUnit 5 的 @TempDir 注解在测试类字段（非方法参数）上使用时，若 Maven 缺少 Surefire 插件配置，会导致运行时 Path 字段为 null——IDE 可能因内置支持而“侥幸”通过，但终端执行必然失败。
junit 5 的 `@tempdir` 注解在测试类字段（非方法参数）上使用时，若 maven 缺少 surefire 插件配置，会导致运行时 `path` 字段为 `null`——ide 可能因内置支持而“侥幸”通过，但终端执行必然失败。
在 JUnit 5 中，@TempDir 支持两种使用方式：作为测试方法参数（推荐）和作为测试类的实例/静态字段。你当前的代码选择后者：
public class FileTest {
@TempDir
private Path tempDir; // ❌ 实例字段 —— 依赖 JUnit Platform 的扩展生命周期管理
@Test
public void testConstructor_FileDoesNotExist_ExpectIllegalArgumentException() {
Path nonExistingFile = Path.of(tempDir.toString(), "NonExistingFile.xls"); // NPE here!
Assertions.assertFalse(nonExistingFile.toFile().exists());
}
}该写法看似简洁，但其正确执行强依赖于 JUnit Platform 的扩展机制被完整激活——而这一机制在 Maven 构建中并非默认启用。关键在于：Maven 的 maven-surefire-plugin 是唯一能桥接 JUnit Jupiter 与 JVM 测试执行环境的标准插件。若 POM 中未显式声明，Maven 将回退到旧版 Surefire（如 2.x），它仅原生支持 JUnit 4，对 JUnit 5 的扩展（如 @TempDir 字段注入、@BeforeEach 生命周期回调等）完全不可见，导致字段未被注入而保持 null。
✅ 正确解决方案：在 pom.xml 中显式配置 maven-surefire-plugin 3.0.0+（推荐 3.2.5 或更高稳定版）：
<build>
<plugins>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.2.5</version>
<configuration>
<!-- 可选：启用详细日志便于调试 -->
<trimStackTrace>false</trimStackTrace>
</configuration>
</plugin>
</plugins>
</build>⚠️ 注意：junit-jupiter-engine 和 junit-jupiter-api 依赖本身不包含执行引擎绑定逻辑；它们仅提供注解与 API。真正负责扫描 @TempDir 字段、触发临时目录创建、并在每个测试方法前后注入/清理路径的，是 Surefire 插件加载的 JUnit Platform Launcher。
? 验证修复效果：
执行 mvn clean test 后，应看到类似日志：
[INFO] --- maven-surefire-plugin:3.2.5:test (default-test) @ file-test --- [INFO] Using auto-detected provider org.junit.platform.surefire.provider.JUnitPlatformProvider
这表明 JUnit Platform 已被正确识别，@TempDir 字段将按预期注入（每个测试方法独享独立临时目录）。
? 更佳实践建议：
- 优先使用方法参数形式（@Test void test(@TempDir Path tempDir)），语义更清晰、生命周期更可控，且兼容性更强；
- 若必须用字段（如多测试共用同一临时空间），请确保 @TempDir 字段为 public 或 protected（JUnit 5 要求可访问性），且避免 final；
- 永远为 @TempDir 字段添加空值防护（尤其在调试阶段）：
@Test void testWithFieldTempDir() { if (tempDir == null) { throw new IllegalStateException("@TempDir field not injected — check Surefire plugin!"); } // ... rest of test }
至此，你的测试将在 IDE 和 CLI 环境下行为一致，彻底告别神秘的 NullPointerException。
