Gradle多模块中common库找不到的问题求助

核心问题分析 #

报错Project with path ':common' could not be found in root project 'intranet'的本质是：你在intranet子模块目录下执行了Gradle构建命令，此时Gradle会加载intranet自身的配置，而非根项目的settings.gradle，导致无法识别:common模块。另外，common模块自带的settings.gradle也会干扰根项目的模块管理逻辑。

分步解决步骤 #

1. 规整目录结构与配置文件 #

确保Git根目录结构如下：

acme/
├── settings.gradle       # 根项目统一配置文件
├── build.gradle          # 根项目全局构建配置
├── common/
│   ├── build.gradle
│   └── src/
├── intranet/
│   ├── build.gradle
│   └── src/
└── extranet/
    ├── build.gradle
    └── src/

删除common模块下的settings.gradle，子模块不需要独立的settings文件，所有模块由根项目的settings.gradle统一管理。

2. 从根目录执行所有Gradle命令 #

所有构建操作必须在**根项目目录（acme/）**下执行，示例命令：

• 构建所有模块：./gradlew build
• 单独构建intranet：./gradlew intranet:build
• 查看项目结构：./gradlew projects

若在子模块目录执行命令，Gradle只会识别当前模块，无法找到兄弟模块。

3. 验证依赖与根配置 #

intranet模块的依赖写法没问题：

implementation project(':common')

根项目settings.gradle的配置也正确，保持当前内容即可：

rootProject.name='acme'
include 'common', 'extranet', 'intranet'

4. 优化common模块构建配置（可选） #

因为common是供其他模块依赖的库，无需打包成Spring Boot可执行jar，修改common的build.gradle避免生成可执行jar（否则依赖时会无法正常引用类）：

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.0.3' apply false
    id 'io.spring.dependency-management' version '1.1.0'
}

group = 'com.acme.lib.common'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

// 禁用Spring Boot可执行jar，保留普通jar
jar {
    enabled = true
}
bootJar {
    enabled = false
}

compileJava.options.encoding = "UTF-8"
compileTestJava.options.encoding = "UTF-8"

repositories {
    mavenCentral()
}

dependencyManagement {
    imports {
        mavenBom org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES
    }
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

验证修复效果 #

1. 在根目录执行./gradlew projects，输出中应包含:common、:intranet、:extranet三个子项目。
2. 执行./gradlew intranet:build，此时可正常依赖common模块完成构建。

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