从Jenkins逗号分隔字符串参数触发TestNG并行测试

步骤1：Jenkins配置参数 #

在Jenkins任务中添加字符串参数，命名为TEST_PARAMS，默认值可设为a,b,c，用户触发任务时可传入任意逗号分隔的字符串（如a,b,c,d）。

步骤2：Gradle配置传递参数并动态调整线程数 #

修改build.gradle中的TestNG配置，将Jenkins参数通过系统属性传递给测试代码，并根据参数数量动态设置线程数：

test {
    useTestNG() {
        options ->
            // 读取Jenkins传入的参数，无传入时用默认值
            def testParams = project.hasProperty('testParams') ? project.testParams : 'a,b,c'
            def paramCount = testParams.split(',').length
            options.parallel = 'tests'
            // 线程数与参数数量一致，确保每个测试用例都能并行执行
            options.threadCount = paramCount
    }
    // 将参数注入JVM系统属性，供测试代码读取
    systemProperty 'test.params', project.hasProperty('testParams') ? project.testParams : 'a,b,c'
}

Jenkins执行Gradle任务时，需传递参数：gradle test -PtestParams=${TEST_PARAMS}

步骤3：修改TestNG数据提供者 #

调整RunIdProvider类的dataProvider方法，读取系统属性中的参数，动态生成测试数据集：

import org.testng.annotations.DataProvider;

public class RunIdProvider {
    @DataProvider(name = "dataProvider")
    public static Object[][] dataProvider() {
        // 读取系统属性，无值时用默认参数
        String params = System.getProperty("test.params", "a,b,c");
        String[] paramArray = params.split(",");
        // 构建TestNG要求的Object[][]格式数据
        Object[][] testData = new Object[paramArray.length][1];
        for (int i = 0; i < paramArray.length; i++) {
            testData[i][0] = paramArray[i].trim(); // 去除参数可能带的空格
        }
        return testData;
    }
}

步骤4：测试代码无需修改 #

原测试方法保持原样，直接复用动态生成的数据提供者：

import org.testng.annotations.Test;

public class YourTestClass {
    @Test(dataProvider = "dataProvider", dataProviderClass = RunIdProvider.class)
    void testFunction(String variable) {
        // 执行你的测试逻辑，例：打印当前测试用例的变量值
        System.out.println("当前测试变量：" + variable);
    }
}

效果验证 #

• 当Jenkins传入a,b,c时，会启动3个并行测试用例，分别使用a、b、c作为参数
• 当传入a,b,c,d时，自动生成4个并行测试用例，线程数同步调整为4，实现全并行执行

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