JUnit5与TestNG混合项目Maven Surefire插件配置失败求助

核心原因分析 #

org.apache.maven.surefire.testset.TestSetFailedException 在Surefire 3.0+版本中被重构，3.0.0-M4属于早期预览版，而3.5.2是稳定版，版本不一致导致类找不到。指定版本不生效的情况，大概率是插件版本被继承链中的其他配置覆盖，或者Maven依赖调解机制拉取了旧版本。

具体解决方法 #

1. 强制锁定Surefire插件版本 #

在父POM的 <pluginManagement> 中明确声明插件版本，确保所有子模块继承时不会被覆盖：

<build>
  <pluginManagement>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>3.5.2</version>
        <!-- 配置同时支持JUnit5和TestNG -->
        <dependencies>
          <dependency>
            <groupId>org.apache.maven.surefire</groupId>
            <artifactId>surefire-junit-platform</artifactId>
            <version>3.5.2</version>
          </dependency>
          <dependency>
            <groupId>org.apache.maven.surefire</groupId>
            <artifactId>surefire-testng</artifactId>
            <version>3.5.2</version>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
  </pluginManagement>
</build>

注意：必须放在 <pluginManagement> 中，才能统一管控所有子模块的插件版本。

2. 检查子模块是否覆盖了插件版本 #

遍历所有子POM，确认没有单独声明 maven-surefire-plugin 的版本，如果有，删除子模块中的版本配置，统一继承父POM的版本。

3. 排查依赖传递中的旧版本 #

执行以下Maven命令，查看Surefire相关插件的依赖树，确认是否有旧版本被引入：

mvn dependency:tree -Dincludes=org.apache.maven.surefire

如果输出中出现3.0.0-M4版本，找到对应的依赖来源，在父POM中通过 <exclusions> 排除旧版本：

<!-- 示例：在导致旧版本引入的依赖中排除 -->
<dependency>
  <groupId>xxx</groupId>
  <artifactId>xxx</artifactId>
  <version>xxx</version>
  <exclusions>
    <exclusion>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
    </exclusion>
  </exclusions>
</dependency>

4. 清理Maven本地仓库缓存 #

旧版本的插件可能缓存到本地仓库，执行以下命令清理：

mvn clean install -U

-U 参数会强制更新快照依赖，同时清理本地仓库中可能存在的旧版插件缓存。

5. 验证插件版本是否生效 #

执行以下命令查看当前项目使用的Surefire插件版本：

mvn help:describe -Dplugin=surefire -Ddetail

在输出中查找 Version 字段，确认是否为3.5.2。

补充配置说明 #

由于项目同时包含JUnit5和TestNG测试类，确保插件依赖中同时引入 surefire-junit-platform 和 surefire-testng，且版本与插件主版本保持一致（3.5.2），这样插件才能正确识别并执行两种类型的测试。

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