Gradle配置build任务依赖其他模块发布任务的报错解决方案

异常配置复盘 #

以下三种写法均无法实现预期效果，对应问题如下：

• 首次尝试写法

task("build").dependsOn(
    gradle.includedBuild("splain").task("publishToMavenLocal")
)

执行报错：Cannot add task 'build' as a task with that name already exists.
根因：Java等核心插件会自动创建build生命周期任务，直接调用task("build")属于重复注册同名任务，触发任务命名冲突。

• 第一次调整写法

tasks {
    build.dependsOn(
        gradle.includedBuild("splain").publishToMavenLocal
    )
}

编译阶段报错：e: /home/peng/git/shapesafe/build.gradle.kts:92:15: Unresolved reference: dependsOn
根因：该闭包内的build是任务委托提供者实例，未直接映射到已存在的build任务对象，同时includedBuild返回的复合构建实例不存在直接的publishToMavenLocal属性，Kotlin静态检查直接判定语法无效。

• 第二次调整写法

tasks.build{
    dependsOn(
        gradle.includedBuild("splain").task("publishToMavenLocal")
    )
}

编译可通过，但执行构建时拉取io.tryp:splain_2.13.8:1.1.0-SNAPSHOT依赖触发远程bintray仓库502错误，日志显示splain模块仅执行到build阶段，未触发publishToMavenLocal任务。
根因：Gradle依赖解析阶段早于build任务执行，项目启动依赖拉取时publishToMavenLocal还未运行，本地Maven仓库无对应快照产物，只能走远程仓库拉取触发网络错误。

正确配置实现 #

需要将splain模块的发布任务挂载到所有依赖解析触发点之前，保证依赖拉取前本地Maven仓库已有对应产物，配置代码如下：

// 给所有编译类任务挂载依赖，确保编译前依赖解析启动前完成splain本地发布
tasks.withType<AbstractCompile>().configureEach {
    dependsOn(gradle.includedBuild("splain").task(":publishToMavenLocal"))
}
// 补全build任务依赖，避免单独执行build任务时漏触发发布流程
tasks.build {
    dependsOn(gradle.includedBuild("splain").task(":publishToMavenLocal"))
}

配置要点：

• 引用复合构建任务时加根路径前缀:，明确匹配splain模块根项目下的publishToMavenLocal任务，避免路径匹配失败
• 给所有编译类任务提前配置依赖，覆盖所有依赖解析触发场景，不会出现依赖拉取早于发布的时序问题
• 配置后执行任意构建命令，都会优先执行splain模块的publishToMavenLocal任务，将快照版本写入本地.m2仓库，主项目依赖解析时优先读取本地产物，不会再请求远程仓库。

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