Gradle Kotlin项目中JUnit5参数化测试的参数数量配置切换方案

方法1：数据源方法中基于系统属性过滤参数（推荐） #

这个方案直接在@MethodSource的参数提供方法中，根据指定系统属性决定返回全量参数还是单个参数，同时通过Gradle配置确保属性能传递到测试JVM进程。

步骤1：修改参数提供方法 #

在每个返回测试参数的静态方法中，添加过滤逻辑：

import org.junit.jupiter.params.provider.MethodSource

class MyParamTest {

    @ParameterizedTest
    @MethodSource("testParams")
    fun myTest(param: TestParam) {
        // 测试逻辑
    }

    @JvmStatic
    fun testParams(): List<TestParam> {
        // 全量测试参数集合
        val fullParams = listOf(
            TestParam("case1"),
            TestParam("case2"),
            TestParam("case3")
            // 更多测试参数...
        )

        // 根据系统属性判断是否只返回单个参数
        return if (System.getProperty("local.test") == "true") {
            fullParams.take(1) // 取第一个参数，也可根据需求调整为取特定参数
        } else {
            fullParams
        }
    }

    data class TestParam(val name: String)
}

步骤2：Gradle配置传递系统属性 #

在build.gradle.kts中配置测试任务，确保系统属性能传递到测试进程：

tasks.test {
    // 当构建时指定了localTest参数，就传递对应的系统属性到测试JVM
    if (project.hasProperty("localTest")) {
        systemProperty("local.test", "true")
    }
    // 若需要传递所有构建时的系统属性，可替换为：
    // systemProperties(System.getProperties())
}

运行方式 #

• 本地开发时执行：./gradlew test -PlocalTest，所有参数化测试都会只运行单个参数实例，且所有测试类都会被执行。
• CI环境或需要全量测试时，直接执行./gradlew test即可。

优化：封装过滤逻辑 #

如果有大量参数提供方法，可封装工具类避免重复代码：

object TestParamFilter {
    fun <T> filter(fullParams: List<T>): List<T> {
        return if (System.getProperty("local.test") == "true") {
            fullParams.take(1)
        } else {
            fullParams
        }
    }
}

之后在参数方法中调用：

@JvmStatic
fun testParams(): List<TestParam> {
    val fullParams = listOf(...)
    return TestParamFilter.filter(fullParams)
}

方法2：创建Gradle专属本地测试任务 #

可以直接在Gradle中创建一个专门的本地测试任务，默认启用单参数模式，无需每次手动加参数：

tasks.register<Test>("localTest") {
    // 继承默认test任务的所有配置
    from(tasks.test)
    // 强制启用单参数模式
    systemProperty("local.test", "true")
}

运行时只需执行：./gradlew localTest，即可实现所有测试类跑单个参数的需求。

为什么之前检查System.properties无效？ #

Gradle的测试任务运行在独立的JVM进程中，默认不会继承构建脚本的系统属性。必须通过systemProperty或systemProperties显式配置，才能让测试代码读取到对应的属性值。

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