Gradle 项目中正确发布与消费传递依赖的完整指南

本文详解如何解决 gradle 构建时无法解析“依赖的依赖”（即传递依赖）的问题，核心在于正确使用 `java-library` 插件与 `api`/`implementation` 配置，确保下游项目自动继承上游库所声明的公共 api 依赖。

在多模块或跨项目协作场景中，常见一类典型问题：上游模块（如 MyStarterWeb）依赖了 Spring Boot Web Starter，而下游模块（如 MyFirstEndPoint）仅声明对上游模块的依赖，却在编译时报错——package org.springframework.boot does not exist。这并非 Gradle 故障，而是依赖传递机制未被正确启用所致。

Gradle 默认的 java 插件仅支持 implementation 配置，该配置下的依赖不会对外暴露，即不会作为传递依赖提供给消费者项目。要使下游项目能自动解析 MyStarterWeb 所依赖的 Spring Boot 类型（如 SpringApplication），必须明确标识哪些依赖是库的 公共 API 组成部分。

✅ 正确做法分两步：

1. 在上游库（MyStarterWeb）中启用 java-library 插件并迁移依赖声明
   修改 build.gradle：

   plugins {
       id 'java-library'  // 替代或补充 'java'；关键！提供 api/implementation 分离能力
       id 'org.springframework.boot' version '3.0.2'
       id 'io.spring.dependency-management' version '1.1.0'
   }
   
   dependencies {
       api 'org.springframework.boot:spring-boot-starter-web:3.0.2'
       api 'javax.servlet:javax.servlet-api:4.0.1'  // 若需暴露 Servlet API
       // ❌ 不要再用 implementation 声明这些需被下游使用的依赖
   }

   ? api 表示该依赖属于库的公共契约，将被包含在 pom.xml 的 中并标记为 compile 范围，从而支持传递解析；而 implementation 仅用于内部实现，不参与传递。

2. 下游项目（MyFirstEndPoint）保持简洁声明即可

   

   青柚面试

   简单好用的日语面试辅助工具

   下载

   dependencies {
       implementation 'com.mygroup:MyStarterWeb:0.0.1-SNAPSHOT'
       // ✅ 不需重复声明 spring-boot-starter-web 或 servlet-api
   }

⚠️ 注意事项：

• 确保 MyStarterWeb 已成功发布（如 ./gradlew publishToMavenLocal），且下游项目仓库配置包含 mavenLocal()；
• 若使用 Maven 发布，java-library 插件会自动生成符合 Maven 语义的 pom.xml，其中 api 依赖以 compile scope 出现，implementation 依赖则被排除；
• Spring Boot 的 spring-boot-starter-* 本身已是 api 友好设计，但只有当你的库显式用 api 引入它时，其传递性才会向上游消费者透出；
• Gradle 6.0+ 强烈推荐使用 java-library 替代旧式 java 插件，避免隐式行为歧义。

总结：依赖能否传递，不取决于“是否用了 Spring Boot”，而取决于你如何声明它。用对 api，才能让模块协作真正解耦、简洁、可维护。