如何在 Gradle 多项目中实现子模块的传递性依赖

本文介绍如何通过 gradle 多项目结构（而非手动打包 jar）正确声明子项目依赖，使 projecta 中声明的 spring 等第三方依赖自动以传递方式生效于 projectb，避免重复声明和依赖缺失。

要让 GradleProjectB 自动继承 GradleProjectA 中定义的 Spring 依赖（即实现传递性依赖），关键在于将两个项目组织为 Gradle 多项目构建（multi-project build），而非独立项目 + 手动引入 JAR 包。JAR 方式默认不携带 compile 或 implementation 作用域的依赖信息，因此无法传递；而子项目依赖（project(':xxx')）则会完整解析其 dependencies 块，从而支持标准的依赖传递机制。

✅ 正确配置步骤

1. 统一根目录，创建 settings.gradle
   在 ParentDirectory 根目录下新建 settings.gradle（或 settings.gradle.kts），声明子项目：

   // ParentDirectory/settings.gradle
   include ':GradleProjectA', ':GradleProjectB'

   ⚠️ 注意：项目名称必须与文件夹名严格一致（如 :GradleProjectA 对应 ParentDirectory/GradleProjectA/），否则同步失败。

2. 在 GradleProjectB/build.gradle 中声明对 A 的依赖
   使用 implementation project(...) —— 这是启用传递性的核心：

   // GradleProjectB/build.gradle
   dependencies {
       implementation project(':GradleProjectA')
       // ✅ Spring 将自动从 GradleProjectA 传递进来
       // ❌ 不需要再写 implementation 'org.springframework:spring-core:6.1.0'
   }

3. 确保 GradleProjectA 使用标准依赖声明
   其 build.gradle 应使用 implementation（而非 compile，已弃用）声明 Spring：

   // GradleProjectA/build.gradle
   dependencies {
       implementation 'org.springframework:spring-core:6.1.0'
       implementation 'org.springframework:spring-context:6.1.0'
       // 其他依赖...
   }

? 验证传递是否生效

运行以下命令检查依赖树：

cd ParentDirectory
./gradlew :GradleProjectB:dependencies --configuration runtimeClasspath

你将在输出中看到类似：

阿里云AI平台

阿里云AI平台

下载

+--- project :GradleProjectA
|    +--- org.springframework:spring-core:6.1.0
|    \--- org.springframework:spring-context:6.1.0

这表明 Spring 依赖已成功由 ProjectA 传递至 ProjectB。

⚠️ 常见误区与注意事项

• 不要用 flatDir 或 fileTree 引入 JAR：它们不解析 POM/Metadata，无法传递依赖；
• 避免 api 误用：除非 ProjectB 需要 编译期使用 ProjectA 的 Spring 类型（如继承 Spring 注解类），否则 implementation project(...) 已足够且更安全；
• 版本冲突时启用依赖约束：若多个子项目引入不同 Spring 版本，可在根 build.gradle 中统一管理：

  allprojects {
      configurations.all {
          resolutionStrategy {
              force 'org.springframework:spring-core:6.1.0'
          }
      }
  }

通过以上配置，Gradle 会将 ProjectA 视为一个“可传递的模块”，完整复用其依赖图谱，真正实现一次声明、处处可用的工程化协作。