本文介绍一种轻量、可配置的方式，通过系统属性在本地开发时自动缩减 junit 5 参数化测试的参数数量，避免手动修改代码或遗漏恢复，同时保持 ci/cd 环境下完整参数集的执行。
在基于 Gradle + Kotlin 的 JUnit 5 项目中，@ParameterizedTest 配合 @MethodSource 是组织多组输入验证逻辑的常用方式。但当参数规模较大（如上百个组合）时，本地快速验证往往只需运行单个典型用例——频繁注释/反注释参数源方法不仅易出错，还破坏了测试的可维护性与可复现性。
一个简洁可靠的解决方案是：在参数提供方法中读取系统属性，按需返回精简或全量参数流。以下为 Kotlin + JUnit 5 的推荐实现（兼容 Java 风格写法）：
class StringProcessingTest {
companion object {
private const val LOCAL_BUILD_PROPERTY = "com.example.localBuild"
@JvmStatic
@ParameterizedTest
@MethodSource
fun `should process string correctly`(input: String) {
// 实际测试逻辑
assert(input.length > 0)
}
@JvmStatic
fun `should process string correctly`(): Stream<String> {
return if (isLocalBuild()) {
Stream.of("quick-test-value") // 本地仅运行此值
} else {
Stream.of("alpha", "beta", "gamma", "delta", "epsilon", /* ...更多 */)
}
}
private fun isLocalBuild(): Boolean {
return java.lang.Boolean.getBoolean(LOCAL_BUILD_PROPERTY)
}
}
}✅ 使用方式：
- 本地运行：./gradlew test -Dcom.example.localBuild=true
- CI/CD 或完整验证：直接 ./gradlew test（不设该属性，默认返回全量参数）
? 关键优势：
- 零侵入性：无需修改测试结构、不引入抽象基类或额外注解；
- 环境隔离明确：行为由 JVM 启动参数控制，与构建脚本（如 gradle.properties 或 CI 环境变量）天然协同；
- Kotlin 友好：利用 companion object 和 @JvmStatic 保证静态方法可见性，符合 JUnit 5 对 @MethodSource 方法的签名要求。
⚠️ 注意事项：
- Boolean.getBoolean() 仅识别形如 -Dkey=true 的系统属性（值必须为字面量 "true"，"1" 或 "yes" 无效）；
- 若需更精细控制（如指定具体参数名、跳过某些参数、或动态过滤），可升级为自定义 JUnit 5 扩展（实现 InvocationInterceptor 或 ParameterResolver），但对大多数场景属于过度设计；
- 在 Gradle 中可将该配置固化为便捷任务，例如：
// build.gradle.kts
tasks.test {
systemProperty("com.example.localBuild", System.getProperty("com.example.localBuild", "false"))
}
tasks.register("testLocal", Test::class) {
dependsOn(tasks.test)
systemProperty("com.example.localBuild", "true")
}这样即可通过 ./gradlew testLocal 一键触发本地精简模式，兼顾效率与一致性。
