gradle 构建时能解析 dgs 依赖的 pom 和 module 文件，但始终缺失 jar 包，根本原因常是未引入必需的 spring boot starter 依赖，导致 gradle 无法正确激活 dgs 的发布坐标与元数据解析逻辑。
gradle 构建时能解析 dgs 依赖的 pom 和 module 文件，但始终缺失 jar 包，根本原因常是未引入必需的 spring boot starter 依赖，导致 gradle 无法正确激活 dgs 的发布坐标与元数据解析逻辑。
Netflix GraphQL DGS（Data Graph Service）库采用模块化发布策略，其核心功能（如 graphql-dgs-client）并非独立可运行的“普通库”，而是设计为与 graphql-dgs-spring-boot-starter 紧密协同工作的组件。该 starter 不仅提供自动配置和依赖传递管理，更重要的是——它声明了 DGS 生态中所有子模块（包括 client、extended-scalars、code-gen 等）所需的 Maven BOM（Bill of Materials）及统一版本约束，并确保 Gradle 能正确识别和拉取带 classifier（如 -jar, -sources, -javadoc）的附属工件。
当你仅声明：
implementation 'com.netflix.graphql.dgs:graphql-dgs-client:6.0.2'
Gradle 会尝试从 Maven Central 下载该坐标对应的 *.jar，但由于 DGS 自 6.x 版本起已弃用传统 jar 主工件发布方式，转而采用 maven-publish 插件 + java-library 模式 + publishing { publications { ... } } 显式定义多种 publication（如 mavenJava, mavenSources, mavenJavadoc）。这意味着：
-
graphql-dgs-client:6.0.2的主 artifact 实际是graphql-dgs-client-6.0.2.module（Gradle Module Metadata），而非graphql-dgs-client-6.0.2.jar； - 其真正的实现 JAR 被归类为
runtime或apiElements变体，并通过variant-aware dependency resolution由 starter 的 BOM 统一协调； - 若缺少 starter，Gradle 无法触发该变体解析流程，最终只缓存
.pom和.module文件（正如你看到的空目录结构），却无法下载实际的.jar。
✅ 正确做法：必须引入 starter 作为入口依赖，再按需添加其他 DGS 模块：
plugins {
id 'org.springframework.boot' version '2.3.2.RELEASE'
id 'io.spring.dependency-management' version '1.0.9.RELEASE'
id 'java'
}
// ✅ 关键修复：添加 starter（自动导入 BOM 并启用 variant 解析）
dependencies {
implementation 'com.netflix.graphql.dgs:graphql-dgs-spring-boot-starter:6.0.2'
// ✅ 此时再声明 client 才能正确解析 JAR
implementation 'com.netflix.graphql.dgs:graphql-dgs-client:6.0.2'
// ✅ extended-scalars 同理（注意版本对齐）
implementation 'com.netflix.graphql.dgs:graphql-dgs-extended-scalars:6.0.2'
implementation 'com.mysql:mysql-connector-j:8.1.0'
implementation 'org.springframework.boot:spring-boot-starter-web'
}
⚠️ 注意事项：
-
版本一致性至关重要：
graphql-dgs-spring-boot-starter、graphql-dgs-client、graphql-dgs-extended-scalars应使用完全相同的主版本号（如全为6.0.2），避免因 BOM 锁定失效导致解析失败； -
Spring Boot 版本兼容性：DGS v6.x 要求 Spring Boot ≥ 2.4.x（你当前使用
2.3.2.RELEASE属于不兼容旧版）。建议升级至 Spring Boot 2.7.x 或 3.x（对应 DGS 7.x+），或降级 DGS 至5.12.0（支持 SB 2.3.x）； -
清理缓存后重试：执行
./gradlew --refresh-dependencies或手动删除~/.gradle/caches/modules-2/files-2.1/com.netflix.graphql.dgs/目录，避免旧 metadata 干扰； -
验证是否生效：构建成功后，检查缓存目录中
7.0.0/.../xxx.jar是否存在，或在 IntelliJ 中展开External Libraries → graphql-dgs-client-6.0.2查看是否包含 class 文件。
? 总结：DGS 不是传统单体库，而是基于 Gradle Variant 和 Spring Boot BOM 的现代依赖体系。跳过 starter 直接引用子模块，等同于绕过“依赖中枢”，必然导致 JAR 缺失。始终以 graphql-dgs-spring-boot-starter 为起点，再扩展功能模块，是稳定集成 DGS 的唯一推荐路径。
