JUnit5中@EnabledIfSystemProperty搭配@ParameterizedTest如何正确禁用灰显？

问题根因 #

这是JUnit 5参数化测试逻辑与IntelliJ IDEA测试运行器的历史兼容问题：@EnabledIfSystemProperty注解作用在@ParameterizedTest上时，会对每一组参数实例单独做条件校验，当所有参数实例都符合禁用条件时，旧版本IDEA会误将无执行用例的测试方法判定为执行通过，而非标记为跳过状态。

解决方法 #

方法1：升级组件版本（最优解） #

同时满足以下两个版本要求即可原生支持灰显效果：

• JUnit Jupiter版本升级到5.9.0及以上
• IntelliJ IDEA版本升级到2022.2及以上

版本匹配后原代码不需要做任何修改，禁用的参数化测试会和普通@Test一样显示为灰显跳过状态。

方法2：使用Assumptions做条件校验（兼容旧版本） #

如果无法升级版本，可以把条件判断移到测试方法内部，用JUnit自带的假设API实现相同效果，代码示例如下：

import org.junit.jupiter.api.Assumptions;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;

@ParameterizedTest
@ValueSource(strings = {"testData.json", "testData2.json"})
public void test(String s) {
    // 前置条件校验，不满足则标记测试为跳过
    Assumptions.assumeTrue(
        "test".equals(System.getProperty("env")),
        "仅允许在test环境执行"
    );
    System.out.println("Only for TEST env");
}

该写法下不满足条件的参数实例会被正确标记为跳过，IDEA测试列表会正常灰显，且跳过的测试不会影响构建结果。

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