Maven Surefire插件无法识别测试套件，执行时检测0测试

1. 确保Surefire插件适配JUnit 5套件运行 #

JUnit 5的测试套件需要Surefire插件明确使用JUnit Platform提供的运行器，默认配置可能不支持。你需要在pom.xml中为Surefire插件添加JUnit Platform依赖，指定使用JUnit Jupiter引擎：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <version>3.1.2</version> <!-- 建议使用最新稳定版 -->
      <dependencies>
        <dependency>
          <groupId>org.junit.platform</groupId>
          <artifactId>junit-platform-surefire-provider</artifactId>
          <version>1.9.3</version>
        </dependency>
        <dependency>
          <groupId>org.junit.jupiter</groupId>
          <artifactId>junit-jupiter-engine</artifactId>
          <version>5.9.3</version>
        </dependency>
      </dependencies>
    </plugin>
  </plugins>
</build>

2. 核对测试套件的注解正确性 #

务必使用JUnit 5套件专属的注解，不要混用JUnit 4的API：

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

@Suite
@SelectClasses({TestClass1.class, TestClass2.class}) // 替换为你的实际测试类
public class TestSuite {
}

注意：如果导入了org.junit.runner.RunWith或JUnit 4的@Suite注解，会导致Surefire无法识别为JUnit 5套件，直接删除这类错误导入。

3. 确认测试套件的编译与类路径 #

• 先执行mvn clean compile test-compile清理并重新编译所有代码，避免套件类未被正确编译的问题。
• 如果测试代码放在src/main/java，确保pom.xml中<testSourceDirectory>配置正确，同时套件类也要位于该目录下；若使用build-helper-maven-plugin添加额外测试源，检查配置是否生效：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>build-helper-maven-plugin</artifactId>
  <version>3.3.0</version>
  <executions>
    <execution>
      <id>add-test-source</id>
      <phase>generate-test-sources</phase>
      <goals>
        <goal>add-test-source</goal>
      </goals>
      <configuration>
        <sources>
          <source>src/main/java</source>
        </sources>
      </configuration>
    </execution>
  </executions>
</plugin>

4. 修正命令行运行参数 #

运行测试套件时，必须指定完全限定类名（如果套件不在默认包下），比如：

mvn test -Dtest=com.yourpackage.TestSuite

或者直接在Surefire插件中配置要运行的套件类，避免命令行参数错误：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.1.2</version>
  <configuration>
    <includes>
      <include>**/TestSuite.java</include>
    </includes>
  </configuration>
  <!-- 之前的依赖配置保留 -->
</plugin>

之后直接执行mvn test即可运行套件。

5. 排除JUnit 4依赖冲突 #

如果项目中存在JUnit 4的传递依赖，会干扰JUnit 5套件的识别。在JUnit 5相关依赖中排除JUnit 4：

<dependency>
  <groupId>org.junit.jupiter</groupId>
  <artifactId>junit-jupiter-api</artifactId>
  <version>5.9.3</version>
  <scope>test</scope>
  <exclusions>
    <exclusion>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
    </exclusion>
  </exclusions>
</dependency>

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