如何将本地Java Gradle项目作为依赖添加至另一项目？附报错解决

问题背景 #

有两个同级文件系统中的项目project1和project2，project2需要依赖project1的代码。在成功构建project1后，构建project2时出现依赖解析失败的错误。

报错信息 #

Could not determine the dependencies of task ':app:distTar'.
> Could not resolve all task dependencies for configuration ':app:runtimeClasspath'.
   > Could not resolve project :project1.
     Required by:
         project :app
      > No matching configuration of project :project1 was found. The consumer was configured to find a runtime of a library compatible with Java 11, packaged as a jar, preferably optimized for standard JVMs, and its dependencies declared externally but:
          - None of the consumable configurations have attributes.

关键配置问题 #

project2的settings.gradle配置 #

当前配置引入了project1根项目，但project1根项目本身是多模块项目（包含lib子模块），根项目没有可被消费的库配置，导致依赖解析失败：

rootProject.name = 'project2'
include('app')

include   ':project1'
project(':project1').projectDir = new File(settingsDir, '../project1')

project2的build.gradle依赖配置 #

错误地直接依赖project1根项目，同时手动引入构建后的jar，不符合Gradle跨项目依赖的规范：

dependencies {
    // ... 其他依赖
    implementation project(':project1')
    implementation files('../../project1/lib/build/libs/lib.jar')
}

解决方案 #

1. 修正project2的依赖目标 #

project1的业务代码实际在lib子模块中，需将依赖指向该子模块而非根项目。修改project2/app/build.gradle：

dependencies {
    // ... 保留原有其他依赖
    // 替换错误的根项目依赖为子模块依赖
    implementation project(':project1:lib')
    // 删除手动引入的jar依赖，Gradle会自动处理依赖的构建与引入
    // implementation files('../../project1/lib/build/libs/lib.jar')
}

2. 确认project1的子模块配置 #

确保project1/settings.gradle已正确包含lib子模块（从文件夹结构看已配置）：

rootProject.name = 'project1'
include(':lib')

3. 统一Java版本（可选但推荐） #

在两个项目的构建脚本中指定相同的Java版本，避免兼容性问题：

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(11)
    }
}

验证步骤 #

1. 进入project1目录，执行构建确保项目正常编译：

./gradlew clean build

2. 进入project2目录，执行构建验证依赖解析是否正常：

./gradlew clean build

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