切换至Java 17后Gradle testDebug任务出现歧义错误如何解决？

问题背景 #

我们的多模块Android项目长期使用./gradlew testDebug命令运行所有子项目的Debug单元测试，但切换到Java 17后，Gradle抛出任务歧义错误，列出了一堆带Flavor前缀的测试任务（如testDevAndroidDebugUnitTest）；而切换回Java 11时，该命令能正常匹配所有子项目的testDebugUnitTest任务。此问题在AGP 7.4.2+Gradle 7.6.1、AGP 8.0.0+Gradle 8.0环境下均能复现。

解决方案 #

方案1：在根项目自定义聚合任务 #

在根项目的build.gradle（或build.gradle.kts）中添加自定义任务，统一聚合所有子项目的testDebugUnitTest任务，保持原有命令的使用习惯：

Groovy版本

task testDebug {
    group = "Verification"
    description = "运行所有子项目的Debug单元测试"
    dependsOn subprojects.tasks.matching { it.name == "testDebugUnitTest" }
}

Kotlin DSL版本

tasks.register("testDebug") {
    group = "Verification"
    description = "运行所有子项目的Debug单元测试"
    dependsOn(subprojects.mapNotNull { it.tasks.findByName("testDebugUnitTest") })
}

添加后直接执行./gradlew testDebug即可，和之前的使用方式完全一致。

方案2：直接使用Gradle任务匹配器 #

无需修改项目配置，直接执行带通配符的命令，匹配所有子项目的testDebugUnitTest任务：

./gradlew **:testDebugUnitTest

方案3：调整Flavor配置（可选） #

如果项目中Flavor维度过多导致测试任务变体泛滥，可以考虑合并或简化Flavor配置，减少不必要的测试任务。此方案可能影响项目结构，需结合业务需求谨慎评估。

原因分析 #

Java 17环境下Gradle的任务匹配逻辑更严格：Java 11时Gradle会自动将testDebug解析为最匹配的testDebugUnitTest任务；但Java 17下存在大量包含testDebug前缀的Flavor测试任务，导致Gradle无法自动确定目标任务，从而抛出歧义错误。

内容的提问来源于stack exchange，提问作者david.mihola