Gradle复合构建报错‘Failed to get Gradle name for :module’求助

问题原因 #

你当前的配置错误地嵌套使用了includeBuild——Gradle复合构建并不支持多层嵌套的includeBuild。你的结构是root通过includeBuild引入modules，modules又通过includeBuild引入module-a和module-b，这种嵌套会导致Gradle无法正确解析子模块的项目标识，从而抛出找不到Gradle名称的错误。

两种可行修复方案 #

方案一：直接在root层引入所有模块构建 #

删除modules/settings.gradle.kts，修改root目录下的settings.gradle.kts：

rootProject.name = "project-root"
includeBuild("modules/module-a")
includeBuild("modules/module-b")

这种方式保留了每个module作为独立Gradle构建的特性，符合你用Git子模块托管各团队库的需求，同时避免了嵌套复合构建的问题。

方案二：将modules作为普通多模块项目 #

如果不需要每个module保持独立构建的特性，可以把整个modules目录作为一个多模块项目：

1. 修改root目录下的settings.gradle.kts：

rootProject.name = "project-root"
include(":modules")
project(":modules").projectDir = file("modules")

2. 修改modules/settings.gradle.kts，替换includeBuild为直接引入子模块：

rootProject.name = "modules"
include(":module-a:a-core")
include(":module-a:a-data")
include(":module-b:b-core")
include(":module-b:b-data")

// 指定子模块的实际路径
project(":module-a:a-core").projectDir = file("module-a/a-core")
project(":module-a:a-data").projectDir = file("module-a/a-data")
project(":module-b:b-core").projectDir = file("module-b/b-core")
project(":module-b:b-data").projectDir = file("module-b/b-data")

3. 调整module-b中对module-a的依赖路径，比如在b-core/build.gradle.kts中：

dependencies {
    implementation(project(":module-a:a-core"))
}

核心提示 #

Gradle的includeBuild设计用来整合独立的顶级构建，并非用于嵌套层级。如果要维持各模块的独立Git仓库特性，方案一是更合适的选择，它既能利用复合构建的依赖替换能力，又符合Git子模块的结构。

内容的提问来源于stack exchange，提问作者Daniel Schröder