JUnit5测试套件中@RepeatedTest重复执行失效问题咨询

这问题我之前帮团队排查过好几次，核心原因是JUnit 5测试套件的默认执行逻辑和单个测试类不一样——单个类运行时，引擎会直接解析并触发@RepeatedTest的重复规则，但套件层面需要确保引擎能识别并处理这种「测试模板」类型的注解。

具体原因分析 #

• 测试模板的识别逻辑差异：@RepeatedTest本质是「测试模板」（Test Template），单个测试类运行时，JUnit引擎会自动为它生成指定次数的测试实例；但套件运行时，早期版本的JUnit平台套件引擎默认不会主动扩展这类模板的调用，只会把它当成普通测试方法执行一次。
• 依赖或版本问题：如果你的JUnit平台套件引擎（junit-platform-suite-engine）版本过低（比如低于5.5.0），它对@RepeatedTest的支持不完善，套件运行时就不会触发重复。
• IDE或构建工具配置限制：有些IDE的JUnit运行配置默认关闭了重复测试支持，或者Maven/Gradle的测试插件版本太旧，无法正确处理套件中的重复测试。

解决办法 #

1. 升级JUnit相关依赖到稳定版

确保你的项目中以下依赖版本一致且足够新（推荐5.9.x及以上）：

• junit-jupiter-api
• junit-jupiter-engine
• junit-platform-suite-engine

比如Maven依赖配置：

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-suite-engine</artifactId>
        <version>1.9.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 确保测试套件注解配置正确

使用标准的@Suite和@SelectClasses/@SelectPackages注解，不要自定义过滤规则排除测试模板：

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

@Suite
@SelectClasses({YourRepeatedTestClass.class, OtherTestClass.class})
public class FullTestSuite {
    // 套件类无需额外代码
}

3. 检查IDE运行配置

以IntelliJ IDEA为例：

• 打开套件的运行配置
• 切换到「JUnit」标签页
• 确保「Repeat tests」选项没有被设置为「1 time only」，或者直接勾选「Enable repeated tests」（不同版本位置可能略有差异）

4. 升级构建工具插件

如果用Maven，确保maven-surefire-plugin版本≥3.0.0：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.1.2</version>
        </plugin>
    </plugins>
</build>

Gradle用户则确保使用最新的junit-platform插件，在build.gradle中：

plugins {
    id 'java'
    id 'org.junit.platform.gradle.plugin' version '1.9.2'
}

验证方法 #

运行套件后，查看测试报告或控制台输出，如果@RepeatedTest的方法后面出现[1 of 3]、[2 of 3]这样的标识，就说明重复执行生效了。

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