Gradle同名不同路径子模块的识别与循环依赖报错解决

Gradle允许存在路径不同但名称相同的子模块（比如:lightweight-dependency:core和:core），你遇到的循环依赖错误是因为依赖声明的语法错误导致Gradle误解析了模块路径，而非重名本身的问题。

问题原因 #

在:core模块的依赖配置中，你引用lightweight-dependency:extra时缺少了开头的冒号。Gradle的路径解析规则是：

• 带开头冒号的是根路径下的绝对模块路径（如:lightweight-dependency:extra）
• 不带开头冒号的是相对于当前模块的相对路径

所以:core里写lightweight-dependency:extra会被Gradle解析为:core:lightweight-dependency:extra——这个模块并不存在，进而导致任务依赖链混乱，触发了误报的循环依赖。

修复步骤 #

1. 修正依赖声明
   在:core模块的build.gradle.kts中，把依赖改为完整的绝对路径引用：

// 错误写法（相对路径，Gradle解析错误）
// implementation("lightweight-dependency:extra")

// 正确写法（绝对路径，指向根目录下的子模块）
implementation(project(":lightweight-dependency:extra"))

2. 确认settings配置正确
   你的settings.gradle.kts里的模块引入语句是正确的，无需修改：

include(":lightweight-dependency:core")
include(":lightweight-dependency:extra") // 依赖于:lightweight-dependency:core
include(":core") // 依赖于:lightweight-dependency:extra

3. 清理缓存并重新构建
   执行以下命令清除Gradle缓存，避免旧的解析残留影响构建：

./gradlew clean build --refresh-dependencies

完成以上步骤后，Gradle就能正确区分:lightweight-dependency:core和:core两个模块，循环依赖的错误也会消失。

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