使用 @repeatedtest 注解可以重复执行同一个测试方法,适用于需要验证多次运行结果一致性的场景。只需在测试方法上添加该注解并指定 name 和 repeatcount 属性即可实现重复调用。

如何配置重复次数与命名模板
通过设置 repeatCount 参数控制执行次数,利用 name 中的占位符动态生成显示名称。例如 {currentRepetition} 表示当前第几次执行,{totalRepetitions} 表示总次数。这样可以在测试报告中清晰区分每次运行的实例。

import org.junit.jupiter.api.RepeatedTest;
import static org.junit.jupiter.api.Assertions.assertTrue;
public class RepeatedTestExample {
@RepeatedTest(value = 5, name = "Run {currentRepetition} of {totalRepetitions}")
public void shouldPassEveryTime() {
assertTrue(true);
}
}
上述代码将执行五次断言检查,每次都会输出类似 “Run 1 of 5” 的名称。若某次执行失败,JUnit 会标记整个 @RepeatedTest 为失败,并记录具体哪一次出错。
如何在重复测试中注入上下文信息
RepetitionInfo 接口可用于获取当前重复执行的元数据,如当前序号、总数等。将其作为参数传入测试方法,可在逻辑中根据执行阶段做出不同行为判断。

import org.junit.jupiter.api.RepeatedTest;
import org.junit.jupiter.api.RepetitionInfo;
import static org.junit.jupiter.api.Assertions.assertEquals;
public class RepetitionContextExample {
@RepeatedTest(3)
public void checkSequence(RepetitionInfo info) {
assertEquals(info.getCurrentRepetition(), info.getTotalRepetitions() - info.getRemainingRepetitions());
}
}
此例中,info.getCurrentRepetition() 返回当前是第几次执行,而 info.getRemainingRepetitions() 表示剩余未执行次数。两者相减应等于当前序号,用于验证状态一致性。
当重复测试中出现异常时如何处理
如果某次重复执行抛出异常,JUnit 5 会中断后续执行并报告失败。建议在测试内部捕获预期异常或使用 assertThrows 包裹可能出错的代码段,避免误报。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











