本文介绍一种轻量、可配置的方式，通过系统属性在本地开发时自动缩减 `@parameterizedtest` 的参数集，避免手动修改代码导致的遗漏或误提交，同时保持 ci/cd 环境中完整参数运行。
在使用 JUnit 5 进行 Kotlin（或 Java）Gradle 项目开发时，@ParameterizedTest 配合 @MethodSource 是组织多组输入验证逻辑的常用方式。但当参数集合庞大（如几十甚至上百个测试用例）时，本地快速验证往往无需全量执行——此时若每次手动注释/切换参数源，极易引发“忘记还原”等低级错误，破坏测试一致性。
一个简洁可靠的解决方案是：在 @MethodSource 关联的静态工厂方法中，依据系统属性动态决定返回的参数流。例如：
class StringProcessingTest {
companion object {
const val LOCAL_BUILD_PROPERTY = "com.example.localBuild"
@JvmStatic
fun provideInputs(): Stream {
return if (isLocalBuild()) {
Stream.of("quick-test-only")
} else {
Stream.of("input-a", "input-b", "input-c", /* ... dozens more */)
}
}
private fun isLocalBuild(): Boolean {
return java.lang.Boolean.getBoolean(LOCAL_BUILD_PROPERTY)
}
}
@ParameterizedTest
@MethodSource("provideInputs")
fun `should process string correctly`(input: String) {
// 实际测试逻辑
assert(input.isNotEmpty())
}
} ✅ 使用方式：
- 本地运行时添加 JVM 参数：
./gradlew test -Dcom.example.localBuild=true
- 在 IntelliJ IDEA 中，可在「Run Configuration → VM Options」填入 -Dcom.example.localBuild=true；
- Gradle 构建脚本中亦可预设（仅建议用于开发环境）：
test { if (project.hasProperty("localBuild")) { systemProperty "com.example.localBuild", "true" } }并通过 ./gradlew test -PlocalBuild 触发。
⚠️ 注意事项：
- Boolean.getBoolean() 读取的是 系统属性值是否为字面量 "true"（区分大小写），而非任意非空字符串；确保传入 true 而非 1 或 yes；
- 此方案不改变测试方法数量（JUnit 仍会为每个参数生成独立测试项），但能显著缩短执行时间；
- 若需更精细控制（如跳过特定参数、统计被裁剪数量、或支持环境变量 fallback），可基于 JUnit 5 的 InvocationInterceptor 自定义扩展，拦截 interceptTestTemplateMethod 并按需过滤参数调用——但这属于进阶场景，多数项目无需复杂度升级。
总结而言，该方案以极小侵入性实现了开发与生产环境的参数策略分离：代码零变更、配置即生效、语义清晰、易于团队对齐，是参数化测试工程化实践中的实用范式。
