Maven Surefire插件默认用JUnit4而非JUnit5的问题及版本异常排查

一、为何Maven依赖树显示JUnit版本为5.9.3/1.9.3而非BOM指定的5.10.1？ #

你的父pom中通过dependencyManagement导入了junit-bom:5.10.1，但依赖树出现低版本，根源在于：

• BOM优先级被干扰：若dependencyManagement中junit-bom的导入顺序靠后，其他先定义的JUnit组件版本会覆盖BOM的配置；另外你手动指定了junit-platform-console-standalone的版本，破坏了BOM的统一版本控制逻辑。
• 传递依赖覆盖：junit-platform-runner自身依赖JUnit 4的junit:junit:4.13.2，如果dependencyManagement未通过BOM统一所有JUnit组件版本，传递依赖会带进来低版本，覆盖BOM指定的5.10.1。

二、为何Surefire自动选择JUnit4 Provider？ #

Surefire插件的自动提供商选择逻辑是：

1. 扫描测试classpath中的核心测试类
2. 若发现JUnit 4核心类（如junit.framework.Test，来自junit:junit:4.13.2依赖），会优先选择JUnit4 Provider
3. 仅当classpath中仅存在JUnit 5相关类时，才会自动选择JUnit5的JUnitPlatformProvider

从依赖树可见，junit-platform-runner:1.9.3直接依赖了JUnit4的核心包，导致测试classpath中存在JUnit4类，因此Surefire自动切换到JUnit4 Provider。

解决方案 #

1. 修复BOM版本不生效问题 #

• 调整dependencyManagement顺序，确保junit-bom优先于其他JUnit相关配置导入：

  <dependencyManagement>
    <dependencies>
      <!-- 优先导入JUnit BOM，确保版本控制优先级最高 -->
      <dependency>
        <groupId>org.junit</groupId>
        <artifactId>junit-bom</artifactId>
        <version>5.10.1</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <!-- 其他dependencyManagement条目放在后面 -->
    </dependencies>
  </dependencyManagement>
  

• 移除所有手动指定版本的JUnit相关依赖，让BOM统一控制版本：

  <dependency>
    <groupId>org.junit.platform</groupId>
    <artifactId>junit-platform-console-standalone</artifactId>
    <scope>test</scope>
    <!-- 移除手动指定的version，由BOM自动控制 -->
  </dependency>
  

• 执行mvn clean dependency:tree验证所有JUnit相关依赖版本是否统一为5.10.1/1.10.1。

2. 强制Surefire使用JUnit5 Provider #

若修复版本后仍有问题（比如需要保留JUnit4依赖），可在maven-surefire-plugin配置中强制指定JUnit5提供商：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.2.1</version>
  <configuration>
    <argLine>--enable-preview --add-modules jdk.incubator.vector</argLine>
    <!-- 强制指定使用JUnit5平台提供商 -->
    <providerChoice>junitplatform</providerChoice>
  </configuration>
</plugin>

3. 清理不必要的依赖 #

junit-platform-runner是JUnit4兼容JUnit5的桥接组件，若不需要兼容JUnit4测试，直接移除该依赖，classpath中不再有JUnit4核心类，Surefire会自动选择JUnit5 Provider。

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