Gradle 构建时能解析 DGS 依赖的 POM 和 module 文件，却无法下载实际的 JAR 包（如 graphql-dgs-client-6.0.2.jar），根本原因在于缺少必需的 Spring Boot Starter 引导依赖，导致 Gradle 无法正确激活 DGS 的依赖传递与仓库配置。
gradle 构建时能解析 dgs 依赖的 pom 和 module 文件，却无法下载实际的 jar 包（如 `graphql-dgs-client-6.0.2.jar`），根本原因在于缺少必需的 spring boot starter 引导依赖，导致 gradle 无法正确激活 dgs 的依赖传递与仓库配置。
Netflix DGS（GraphQL Data Graph Service）框架的模块设计遵循“Starter 优先”原则：其核心功能模块（如 graphql-dgs-client、graphql-dgs-extended-scalars）并非独立可运行的库，而是依赖 graphql-dgs-spring-boot-starter 进行统一版本管理、自动配置及依赖仲裁。当仅声明 graphql-dgs-client 等非 starter 模块时，Gradle 会尝试从 Maven Central 解析该 artifact，但由于 DGS 自 6.x 版本起已将部分模块（尤其是客户端工具类）发布为 pom-only 或 module-only 形式（即不包含 jar/sources.jar），仅提供元数据用于依赖图构建——这正是你在 .gradle/caches/... 中看到仅有 .pom 和 .module 文件、却无 .jar 的原因。
✅ 正确做法是：始终以 graphql-dgs-spring-boot-starter 作为主依赖引入，其他 DGS 模块应通过 starter 的 BOM（Bill of Materials）机制自动拉取兼容版本，而非手动指定版本号。
✅ 推荐配置（修改 build.gradle）
plugins {
id 'org.springframework.boot' version '2.3.2.RELEASE'
id 'io.spring.dependency-management' version '1.0.9.RELEASE'
id 'java'
}
group = 'com.abc'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'
repositories {
mavenCentral()
}
dependencies {
implementation 'org.springframework.boot:spring-boot-starter-web'
// ✅ 关键：引入官方 starter（自动管理所有 DGS 子模块版本）
implementation 'com.netflix.graphql.dgs:graphql-dgs-spring-boot-starter'
// ❌ 移除手动声明的 client 和 extended-scalars（避免版本冲突）
// implementation group: 'com.netflix.graphql.dgs', name: 'graphql-dgs-client', version: '6.0.2'
// implementation 'com.netflix.graphql.dgs:graphql-dgs-extended-scalars:7.2.0'
// ✅ 如需扩展标量，starter 已包含基础支持；若需额外标量，使用无版本声明方式（由 starter BOM 控制）
implementation 'com.netflix.graphql.dgs:graphql-dgs-extended-scalars'
implementation 'com.mysql:mysql-connector-j:8.1.0'
testImplementation('org.springframework.boot:spring-boot-starter-test') {
exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
}
}
test {
useJUnitPlatform()
}
⚠️ 注意事项
-
不要混用显式版本 + starter：手动指定
graphql-dgs-client:6.0.2会覆盖 starter 内置的版本约束（例如 starter 6.0.2 实际依赖的是client:6.0.2，但 starter 7.3.2 可能要求client:7.3.2），极易引发NoSuchMethodError或ClassCastException。 -
验证依赖树：执行
./gradlew dependencies --configuration runtimeClasspath | findstr "dgs"（Windows）或grep dgs（Linux/macOS），确认graphql-dgs-client出现在graphql-dgs-spring-boot-starter的子依赖中，且版本一致。 -
清理缓存（必要时）：若之前已失败下载，建议执行
./gradlew clean && ./gradlew --refresh-dependencies清除损坏缓存并强制重解析。 -
Spring Boot 版本兼容性：DGS 6.x+ 要求 Spring Boot 2.4+ 或 3.x；你当前使用的
2.3.2.RELEASE属于较旧版本，强烈建议升级至 Spring Boot 2.7.x（LTS）或 3.1+，以获得完整 DGS 7.x 支持和安全更新。
✅ 总结
Gradle 下载 DGS JAR 失败的本质，不是网络或仓库问题，而是项目缺失了 DGS 生态的“入口依赖”。graphql-dgs-spring-boot-starter 不仅提供自动配置，更承担着依赖协调中心的角色——它确保所有 DGS 模块版本对齐、JAR 包完整下载、以及与 Spring Boot 生命周期无缝集成。坚持“starter 为先、子模块按需引入、版本交由 BOM 管理”的原则，即可彻底解决此类问题。
