如何让JUnit 5避免重复执行已包含在@Suite中的测试？

要解决JUnit 5中测试套件和套件内测试类重复执行的问题，无需修改构建脚本或指定运行套件，可通过标签过滤+JUnit平台配置文件实现，这是跨构建工具的通用方案：

步骤1：给套件内的测试类添加专属标签 #

给所有需要仅通过套件执行的测试类添加@Tag注解，标记为suite-only（标签名可自定义）：

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

@Tag("suite-only")
public class ExampleClass {

  @Test
  public void test() {
    System.out.println("test");
  }

}

步骤2：配置测试套件包含该标签 #

修改测试套件，添加@IncludeTags注解，确保套件能扫描到带标签的测试类：

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

@Suite
@IncludeTags("suite-only")
@SelectClasses({
  ExampleClass.class
})
public class ExampleSuite {
}

步骤3：添加JUnit平台配置文件排除标签 #

在src/test/resources目录下创建junit-platform.properties文件，添加以下配置，让默认测试扫描排除带suite-only标签的类：

junit.jupiter.tags.exclude=suite-only

效果验证 #

执行gradle test（或mvn test）后，测试类只会通过套件执行一次，不会再单独重复运行。

原理：默认测试运行时会读取配置文件，排除标记为suite-only的测试类；而测试套件通过@IncludeTags强制包含这些类，从而实现仅通过套件执行一次的效果，且无需修改任何构建脚本或运行命令。

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