如何让Gradle跳过Java类未变更的多项目（>20）中的测试任务？

我明白你在多项目Git仓库里想优化测试执行速度的需求——只跑那些代码有变更的项目的测试，确实能省不少时间。你之前尝试指定build/classes/main作为测试输入、build/classes/test作为输出没成功，问题出在对Gradle增量构建输入输出的理解上，咱们一步步来解决：

为什么之前的配置没生效？ #

Gradle的Test任务的增量判断核心是识别哪些变更会影响测试结果，而不是简单的class文件。你之前指定的build/classes/test其实是compileTestJava任务的输出，不是Test任务的输出——测试任务的输出应该是测试报告、测试执行结果这类文件，而不是编译后的测试类。另外，测试的输入除了主类class文件，还得包括测试类本身、测试依赖、测试资源，少了这些Gradle没法准确判断要不要跳过测试。

正确的增量测试配置（基础版） #

其实Gradle的Test任务默认已经内置了增量支持，只要你没修改过默认的任务配置，它会自动检测：

• 输入：主类编译产物、测试类编译产物、测试资源、测试依赖
• 输出：测试结果目录（build/test-results）、测试报告目录（build/reports/tests）

如果之前你手动修改过配置破坏了默认行为，可以在子项目的build.gradle里明确恢复：

test {
    // 明确指定测试任务的输入源
    inputs.files sourceSets.main.output
    inputs.files sourceSets.test.output
    inputs.files sourceSets.test.resources

    // 明确指定测试任务的输出目录
    outputs.dir layout.buildDirectory.dir("test-results")
    outputs.dir layout.buildDirectory.dir("reports/tests")
}

这样配置后，只要项目的主类、测试类、测试资源没变化，Gradle就会跳过该项目的测试任务。

结合Git变更过滤测试项目（进阶版） #

如果你想更进一步，只针对Git上次构建以来有代码变更的项目运行测试，可以在根项目的build.gradle里添加以下配置，通过Git命令识别变更项目，再过滤测试任务：

// 注册一个任务，用来获取Git变更的子项目
def changedProjectsTask = tasks.register("changedProjects") {
    doLast {
        // 执行Git命令，获取上次提交以来变更的文件路径
        def gitDiffOutput = exec {
            commandLine "git", "diff", "--name-only", "HEAD^", "HEAD"
            standardOutput = new ByteArrayOutputStream()
        }.standardOutput.toString().trim()

        // 从变更文件路径中提取对应的子项目
        def affectedProjects = gitDiffOutput.split("\n").collect { filePath ->
            def projectPath = filePath.split("/")[0]
            findProject(":${projectPath}")
        }.unique().findAll { it != null }

        // 把变更项目存到扩展属性，供其他任务使用
        project.ext.affectedProjects = affectedProjects
    }
}

// 配置所有Test任务，只在变更项目中执行
tasks.withType(Test) {
    onlyIf {
        def changedProjects = project.ext.affectedProjects ?: []
        changedProjects.contains(project)
    }
    // 先执行变更项目识别任务
    dependsOn changedProjectsTask
}

现在运行./gradlew test，Gradle就只会执行那些Git提交中涉及变更的项目的测试任务了。

常见问题排查 #

• 确保Gradle构建缓存是开启的：默认是开启的，不要加--no-build-cache参数，否则增量检测会失效
• 检查是否有其他任务干扰：比如有些自定义任务会无差别修改build目录下的文件，导致Gradle误判输入变更
• 跨项目依赖的情况：如果项目A依赖项目B，当B的主类变更时，Gradle会自动触发A的测试（因为A的测试依赖A的编译，而A的编译依赖B的产物），这部分是自动处理的，不需要额外配置

内容的提问来源于stack exchange，提问作者Gregg Wilson