Gradle复合构建中合并clean与build单任务失败问题求助

问题原因分析 #

两个现象本质是同一问题：未正确控制clean与build任务的执行顺序，且Gradle的任务输入输出快照机制导致部分任务未触发重新执行。

1. cleanBuildAll任务失败原因
   当直接将cleanAll和buildAll作为同一任务的并列依赖时，Gradle可能未严格保证clean在build之前完成（尤其是跨included build的任务）。kaptTestKotlin任务需要依赖Project A的jar产物，但clean已删除该jar，而build任务的编译子任务可能因Gradle的up-to-date检查（认为输入无变化）未重新生成jar，导致kapt找不到依赖文件。

2. buildA任务首次执行不跑测试原因
   同样是顺序与快照机制问题：当buildA同时依赖:clean和:build，Gradle可能在clean执行后，测试任务的输入快照已提前生成（认为源文件无变化），即使输出被clean删除，也会判定为up-to-date而跳过；第二次执行时无clean操作，测试任务因输出不存在，会触发完整执行。

解决方案 #

1. 正确控制clean与build的执行顺序 #

不要直接将clean和build作为同一任务的并列依赖，而是通过mustRunAfter强制clean在build之前执行，确保所有子构建的clean完成后再触发build：

// 根目录build.gradle中配置
task cleanBuildAll {
    gradle.includedBuilds.each { includedBuild ->
        def cleanTask = includedBuild.task(':clean')
        def buildTask = includedBuild.task(':build')
        // 强制当前构建的build在clean之后执行
        buildTask.mustRunAfter cleanTask
        // 依次添加依赖
        dependsOn cleanTask
        dependsOn buildTask
    }
}

2. 修复单个模块的buildA任务 #

对于单独模块的任务，同样需要明确顺序约束，避免并行执行导致的问题：

// 根目录或对应模块的build.gradle中配置
task buildA {
    def cleanA = gradle.includedBuild('A').task(':clean')
    def buildA = gradle.includedBuild('A').task(':build')
    buildA.mustRunAfter cleanA
    dependsOn cleanA
    dependsOn buildA
}

3. 检查kapt任务依赖配置 #

确保kaptTestKotlin任务正确依赖于Project A和B的编译任务，而非直接依赖jar文件：

// Project C的build.gradle中配置
tasks.named('kaptTestKotlin') {
    dependsOn gradle.includedBuild('A').task(':compileJava')
    dependsOn gradle.includedBuild('B').task(':compileJava')
}

关键原理说明 #

Gradle的任务调度优先保证依赖关系，但跨included build的任务默认没有顺序约束；同时，任务的up-to-date检查基于输入快照，而非输出是否存在。通过mustRunAfter强制顺序，能确保clean删除产物后，build的所有子任务（编译、测试、kapt等）都会重新执行，避免因产物缺失导致的错误。

内容的提问来源于stack exchange，提问作者Tech Noob