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。
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 的模块系统是否偷偷拦截了反射调用。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
