Java单元测试环境的核心是确保JUnit能被正确识别和执行，关键在于依赖范围设为test、避免JUnit4混用、IDE配置正确及Spring Boot版本匹配。
Java 单元测试环境的核心不是“配环境”，而是让 JUnit 能被编译器识别、被构建工具执行、被 IDE 正确加载 —— 大多数失败都卡在依赖范围或类路径上。
为什么 mvn test 找不到 org.junit.jupiter.api.Test？
这是 Maven 项目最常见报错，本质是 JUnit 5 的 API 没进测试类路径。JUnit 5 拆成了三个模块，只加 junit-jupiter 就够了，但必须用 test scope：
<dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter</artifactId> <version>5.10.2</version> <scope>test</scope> </dependency>
-
scope=test是关键：它确保该依赖只参与编译和运行测试，不打进最终 jar - 别用
junit:junit:4.x混搭 —— JUnit 4 的@Test和 JUnit 5 的@Test类型不同，编译直接失败 - Maven 默认只执行
**/Test*.java、**/*Test.java、**/*Tests.java，类名不匹配会静默跳过
IntelliJ 中右键 Run 'xxxTest' 提示 “No tests were found”
不是代码问题，是 IntelliJ 没识别出测试框架。检查两个地方：
- Project Settings → Modules → Dependencies：确认
junit-jupiter的 Scope 是Test（图标应为绿色小试管） - Project Settings → Libraries：删掉手动添加的
junit-4.13.2.jar等旧版 jar —— 它们会干扰自动检测 - File → Project Structure → Project → SDK：确保 Project SDK 和 Module SDK 都指向 JDK 8+（JUnit 5 不支持 JDK 7）
改完后点 Reload project（Maven 工具窗里的刷新按钮），别只重启 IDE。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
Spring Boot 项目里 @SpringBootTest 启动失败，报 NoClassDefFoundError: org/springframework/boot/test/context/BootstrapContextLoader
这是 Spring Boot 版本和测试 starter 不匹配。Spring Boot 2.6+ 默认禁用 JUnit 4 支持，且要求显式引入 spring-boot-starter-test：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
</exclusion>
</exclusions>
</dependency>
-
exclusions块防止 JUnit 4 引擎被意外拉入，避免与 JUnit 5 冲突 - Spring Boot 3.x 要求 JDK 17+，若用 JDK 11 运行会抛
IncompatibleClassChangeError，和测试代码无关 -
@SpringBootTest类必须放在src/test/java下，且包路径无需与主应用一致 —— 但类名不能以Application结尾，否则会被误判为主启动类
真正麻烦的从来不是写第一个 @Test，而是当 ClassNotFoundException 出现在嵌套的测试引擎加载器里时，你得意识到：问题不在你的代码，而在 maven-surefire-plugin 版本、IDE 缓存、或 JDK 的模块系统是否偷偷拦截了反射调用。
