Junit5测试遇NoClassDefFoundError及无测试用例执行问题求助

场景1：maven-surefire-plugin:2.22.2搭配karate-junit5:1.3.1无测试用例执行 #

原因 #

Surefire 2.x版本对JUnit 5的支持不完善，默认未启用JUnit Jupiter测试引擎；同时项目中的TestNG依赖会干扰引擎选择，导致Karate的JUnit 5测试类无法被识别。

解决方案 #

在pom.xml中明确配置Surefire插件使用JUnit Jupiter引擎，并排除TestNG的干扰：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.22.2</version>
    <dependencies>
        <!-- 强制引入兼容的JUnit Jupiter引擎 -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.7.2</version>
        </dependency>
    </dependencies>
    <configuration>
        <!-- 排除TestNG测试组，避免引擎冲突 -->
        <excludedGroups>testng</excludedGroups>
        <!-- 指定测试类匹配规则，确保目标测试类被扫描 -->
        <includes>
            <include>**/*Test.java</include>
        </includes>
    </configuration>
</plugin>

场景2：切换至maven-surefire-plugin:3.0.0-M7后出现java.lang.NoClassDefFoundError: org/apache/maven/surefire/api/testset/TestSetFailedException #

原因 #

Surefire 3.0.0-M7属于预览版本，API结构发生重构，TestSetFailedException的包路径变更，但Karate 1.3.1依赖的旧版Surefire API与之不兼容，导致类加载失败。

解决方案 #

1. 升级Surefire至稳定兼容版本：建议使用3.2.5（兼容JDK 8和JUnit 5的稳定版），并明确指定JUnit Jupiter引擎：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.2.5</version>
    <configuration>
        <!-- 指定使用JUnit Jupiter引擎 -->
        <providerSelection>junit-jupiter</providerSelection>
        <!-- 精准匹配目标测试类 -->
        <includes>
            <include>**/AppTest.java</include>
        </includes>
    </configuration>
</plugin>

2. 隔离TestNG依赖：如果TestNG仅用于其他场景，设置其依赖作用域为test或provided，避免干扰JUnit测试的类加载：

<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>你的TestNG版本号</version>
    <scope>test</scope>
</dependency>

验证步骤 #

• 执行测试时添加-X参数查看详细日志，确认测试引擎是否正确加载：

  $ mvn test -Dtest=com.app.AppTest -DskipTests=false -X
  

• 清理Maven缓存并重新下载依赖，避免版本冲突：

  $ mvn clean install -U
  

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