使用JUnit5运行单元测试时遇NoClassDefFoundError问题求助

排查依赖配置 #

1. 检查JUnit Jupiter API的依赖范围
   确保POM中junit-jupiter-api的依赖范围为test，避免设置为provided等范围导致IDE运行测试时无法加载类。配置示例：

   <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
       <version>你的版本号</version>
       <scope>test</scope>
   </dependency>
   

2. 统一JUnit版本，避免依赖冲突
   从依赖树结果来看，大概率是不同版本的JUnit Jupiter依赖引发的问题，推荐使用Maven的junit-bom统一管理版本：

   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.junit</groupId>
               <artifactId>junit-bom</artifactId>
               <version>5.10.0</version> <!-- 可替换为最新稳定版 -->
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   

   之后引入依赖无需指定版本，自动对齐统一版本：

   <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
       <scope>test</scope>
   </dependency>
   <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
   </dependency>
   

清理缓存与重新加载 #

1. 清除IDE缓存
   在IntelliJ IDEA中执行File -> Invalidate Caches...，选择Invalidate and Restart，重启后IDE会重新识别依赖。
2. 刷新Maven依赖
   执行以下命令强制清理本地仓库并重新下载依赖：

   mvn clean install -U
   

检查测试运行配置 #

确认IDEA的测试运行配置使用的是JUnit 5（Jupiter）而非JUnit 4，同时查看模块依赖列表中是否包含junit-jupiter-api的jar包。

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