JUnit4迁移至JUnit5后测试套件无法执行的问题求助

项目背景 #

项目采用多Maven模块架构：

• parent pom
  • backend project
  • core project
    • some modules
    • test suite module
      • TestSuite.java
  • ... other projects

已完成JUnit4到JUnit5的测试迁移，原JUnit4测试套件代码：

import org.junit.extensions.cpsuite.ClasspathSuite;
import org.junit.extensions.cpsuite.ClasspathSuite.ClassnameFilters;
import org.junit.runner.RunWith;

@RunWith(ClasspathSuite.class)
@ClassnameFilters({"common.package.of.all.projects.*"})
public class TestSuite {
   
}

迁移后JUnit5的测试套件代码：

import org.junit.platform.suite.api.SelectPackages;
import org.junit.platform.suite.api.Suite;

@Suite
@SelectPackages("common.package.of.all.projects.*")
public class TestSuite {
    
}

测试套件模块pom.xml关键依赖：

<!-- 用于Eclipse执行测试套件 -->
<dependency>
  <groupId>io.takari.junit</groupId>
  <artifactId>takari-cpsuite</artifactId>
  <scope>test</scope>
</dependency>
<!-- 新增JUnit5套件依赖 -->
<dependency>
    <groupId>org.junit.platform</groupId>
    <artifactId>junit-platform-suite-api</artifactId>
    <version>1.8.2</version>
    <scope>test</scope>
 </dependency>
 <dependency>
      <groupId>org.junit.platform</groupId>
      <artifactId>junit-platform-suite-engine</artifactId>
      <version>1.8.2</version>
      <scope>test</scope>
 </dependency>
<!-- 依赖其他模块的test-jar -->
 <dependency>
      <groupId>${project.groupId}</groupId>
      <artifactId>module.name</artifactId>
      <version>${project.version}</version>
      <type>test-jar</type>
      <scope>test</scope>
  </dependency>
  ...

问题现象 #

使用IntelliJ IDE + JDK 17.0.5运行测试套件时，无任何测试用例执行，报错如下：

WARNING: Third-party TestEngine implementations are forbidden to use the reserved 'junit-' prefix for their ID: 'junit-platform-suite'
Internal Error occurred.
org.junit.platform.commons.JUnitException: TestEngine with ID 'junit-platform-suite' failed to discover tests
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discoverEngineRoot(EngineDiscoveryOrchestrator.java:111)
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discover(EngineDiscoveryOrchestrator.java:85)
    at org.junit.platform.launcher.core.DefaultLauncher.discover(DefaultLauncher.java:92)
    at org.junit.platform.launcher.core.DefaultLauncher.execute(DefaultLauncher.java:75)
    at com.intellij.junit5.JUnit5IdeaTestRunner.startRunnerWithArgs(JUnit5IdeaTestRunner.java:57)
    at com.intellij.rt.junit.IdeaTestRunner$Repeater$1.execute(IdeaTestRunner.java:38)
    at com.intellij.rt.execution.junit.TestsRepeater.repeat(TestsRepeater.java:11)
    at com.intellij.rt.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:35)
    at com.intellij.rt.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:235)
    at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:54)
Caused by: java.lang.NoSuchMethodError: 'org.junit.platform.launcher.core.LauncherDiscoveryRequestBuilder org.junit.platform.launcher.core.LauncherDiscoveryRequestBuilder.parentConfigurationParameters(org.junit.platform.engine.ConfigurationParameters)'
    at org.junit.platform.suite.commons.SuiteLauncherDiscoveryRequestBuilder.build(SuiteLauncherDiscoveryRequestBuilder.java:198)
    at org.junit.platform.suite.engine.SuiteTestDescriptor.discover(SuiteTestDescriptor.java:102)
    at java.base/java.util.stream.ForEachOps$ForEachOp$OfRef.accept(ForEachOps.java:183)
    at java.base/java.util.stream.ReferencePipeline$3$1.accept(ReferencePipeline.java:197)
    at java.base/java.util.Iterator.forEachRemaining(Iterator.java:133)

已完成的操作：在parent pom的spring-boot-starter-test中排除junit-vintage-engine：

<dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-test</artifactId>
          <version>${spring.boot.version}</version>
          <scope>test</scope>
          <exclusions>
            <exclusion>
              <groupId>org.junit.vintage</groupId>
              <artifactId>junit-vintage-engine</artifactId>
            </exclusion>
          </exclusions>
        </dependency>

解决思路 #

1. 统一JUnit平台版本，解决依赖冲突 #

报错中的NoSuchMethodError是典型的版本不兼容问题，junit-platform-suite-engine 1.8.2依赖的JUnit Platform核心版本可能和Spring Boot引入的版本不一致：

• 在parent pom的<dependencyManagement>中导入JUnit BOM，统一所有相关组件版本：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.junit.platform</groupId>
      <artifactId>junit-platform-bom</artifactId>
      <version>1.9.3</version> <!-- 选择兼容Spring Boot的最新稳定版 -->
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-bom</artifactId>
      <version>5.9.3</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

• 移除测试套件模块中单独指定的junit-platform-suite-api和junit-platform-suite-engine版本，通过BOM自动管理。

2. 移除冲突的第三方套件依赖 #

takari-cpsuite是JUnit4时代的类路径套件工具，和JUnit5的Suite组件冲突，会导致TestEngine ID警告，直接删除该依赖：

<!-- 删除以下依赖 -->
<dependency>
  <groupId>io.takari.junit</groupId>
  <artifactId>takari-cpsuite</artifactId>
  <scope>test</scope>
</dependency>

JUnit5的@Suite和@SelectPackages本身支持类路径扫描测试用例，无需额外第三方工具。

3. 修正测试套件的包扫描配置 #

@SelectPackages参数不需要加*，*会被当作包名的一部分导致扫描失败，直接指定根包名即可：

import org.junit.platform.suite.api.SelectPackages;
import org.junit.platform.suite.api.Suite;

@Suite
@SelectPackages("common.package.of.all.projects") // 去掉末尾的*
public class TestSuite {
    
}

如果需要更精细的过滤，可配合@IncludeClassNamePatterns使用：

import org.junit.platform.suite.api.IncludeClassNamePatterns;
import org.junit.platform.suite.api.SelectPackages;
import org.junit.platform.suite.api.Suite;

@Suite
@SelectPackages("common.package.of.all.projects")
@IncludeClassNamePatterns(".*Test") // 只匹配以Test结尾的类
public class TestSuite {
    
}

4. 验证测试类符合JUnit5规范 #

检查所有迁移后的测试类：

• 使用JUnit5的注解（org.junit.jupiter.api.Test而非org.junit.Test）
• 测试类和方法为public访问权限（或默认包权限，不推荐）
• 测试方法无返回值、无参数

5. 检查IntelliJ IDE配置 #

• 确保测试套件的Run Configuration中，Test kind选择Test Suite，Test runner为JUnit5
• 执行File → Invalidate Caches...清理缓存并重启IDE，避免旧编译缓存影响测试发现

6. Maven命令行验证 #

跳过IDE直接用Maven命令执行测试套件，排查是否为IDE配置问题：

mvn test -Dtest=TestSuite

如果命令行能正常执行，说明是IntelliJ配置问题，重新导入Maven项目即可。

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