如何通过编程方式调用JUnit 5的@ParameterizedTest？

核心原因 #

参数化测试依赖junit-jupiter-params模块，若在非测试环境（如主代码中的控制器）调用测试时，未正确引入该依赖或未配置JUnit平台加载参数化测试扩展，就会导致@ParameterizedTest方法被忽略。

步骤1：完善Gradle依赖配置 #

在build.gradle中确保以下依赖被正确引入（注意：若调用测试的类在src/main目录，需将依赖范围从testImplementation改为implementation，否则主代码无法访问）：

dependencies {
    // JUnit Platform Launcher
    implementation 'org.junit.platform:junit-platform-launcher:1.9.3'
    // JUnit Jupiter核心测试引擎
    implementation 'org.junit.jupiter:junit-jupiter-engine:5.9.3'
    // 参数化测试专属依赖
    implementation 'org.junit.jupiter:junit-jupiter-params:5.9.3'
    // 若使用TestKit，需额外引入
    implementation 'org.junit.platform:junit-platform-testkit:1.9.3'
}

注：版本请匹配JUnit 5对Java 8的兼容要求，推荐选择5.8.x及以上版本（Java 8支持到JUnit Jupiter 5.9.x）。

步骤2：正确配置Launcher执行逻辑 #

确保LauncherDiscoveryRequest正确选择测试类，并启用JUnit Jupiter引擎，同时注册监听捕获测试结果。示例代码如下：

import org.junit.platform.engine.discovery.DiscoverySelectors;
import org.junit.platform.launcher.Launcher;
import org.junit.platform.launcher.LauncherDiscoveryRequest;
import org.junit.platform.launcher.core.LauncherDiscoveryRequestBuilder;
import org.junit.platform.launcher.core.LauncherFactory;
import org.junit.platform.launcher.listeners.SummaryGeneratingListener;
import org.junit.platform.launcher.listeners.TestExecutionSummary;

public class TestTriggerController {

    public void runParameterizedTests() {
        // 构建测试发现请求，指定目标测试类
        LauncherDiscoveryRequest request = LauncherDiscoveryRequestBuilder.request()
                .selectors(DiscoverySelectors.selectClass(YourTestClass.class))
                .build();

        Launcher launcher = LauncherFactory.create();
        SummaryGeneratingListener listener = new SummaryGeneratingListener();

        // 注册结果监听器
        launcher.registerTestExecutionListeners(listener);
        // 执行测试
        launcher.execute(request);

        // 输出测试汇总结果
        TestExecutionSummary summary = listener.getSummary();
        summary.printTo(System.out);
    }
}

步骤3：检查测试类访问权限 #

• 确保@ParameterizedTest方法和对应的@MethodSource数据源方法为public权限（你的代码已满足此要求）。
• 若测试类在src/test目录，主代码调用时需调整包结构或在Gradle中配置测试类可被主代码依赖访问。

验证执行 #

运行上述runParameterizedTests方法后，控制台会输出参数化测试的执行详情，包括每个参数化用例的运行状态。

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