gradle管理java项目依赖的核心是build.gradle中声明repositories和dependencies：仓库按顺序查找，优先使用阿里云镜像等高速源；依赖用implementation等作用域替代已废弃的compile；多模块项目可在settings.gradle统一配置仓库以避免重复。
Java 项目中使用 Gradle 管理依赖，核心是通过 build.gradle（或 build.gradle.kts）配置依赖坐标和仓库地址。Gradle 默认只用 Maven Central，若需引入其他源（如阿里云镜像、JCenter 归档库、私有 Nexus/Artifactory），必须显式声明仓库；否则会报“Could not find”错误。
在 build.gradle 中声明多个仓库源
仓库声明放在 repositories 块中，顺序影响解析优先级：Gradle 从上到下查找依赖，找到即停。推荐把响应快、覆盖全的镜像放前面。
示例（Groovy DSL）：
repositories {
// 阿里云 Maven 镜像（国内推荐，速度快）
maven { url 'https://maven.aliyun.com/repository/public' }
// Maven Central（官方主源，兜底）
mavenCentral()
// JCenter 已停更，仅作兼容可保留（不建议新增）
// jcenter()
// 私有仓库（需认证时加 credentials）
maven {
url 'https://nexus.example.com/repository/maven-releases/'
credentials {
username = project.findProperty("nexusUsername") ?: System.getenv("NEXUS_USER")
password = project.findProperty("nexusPassword") ?: System.getenv("NEXUS_PASS")
}
}
}
正确声明依赖（implementation vs compile）
Gradle 5.0+ 废弃了 compile，统一用 implementation（推荐）、api（用于库模块暴露传递依赖）或 runtimeOnly（如 JDBC 驱动）。
- implementation：当前模块需要，但不对外暴露（最常用）
- api：当前模块用，且下游模块也要用（适用于开发 SDK 或公共库）
- testImplementation：仅测试代码使用（如 JUnit、Mockito）
示例：
dependencies {
implementation 'org.springframework.boot:spring-boot-starter-web:3.2.0'
implementation 'com.google.guava:guava:33.1.0-jre'
testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
}
处理仓库不可用或依赖缺失
常见问题及应对方式：
- 某仓库返回 403 或 401：检查是否需认证，确认
credentials是否生效，或是否误用了 snapshot 仓库地址 - 依赖在 Maven Central 找不到，但在其他源存在（如 Spring Snapshot）：必须添加对应仓库，例如
maven { url 'https://repo.spring.io/snapshot' } - 多仓库同名依赖版本冲突：Gradle 使用第一个成功解析的版本，不合并；可通过
dependencyInsight任务排查：./gradlew dependencyInsight --dependency guava - 离线构建：启用
--offline，但所有依赖必须已缓存；首次构建务必联网下载
使用 settings.gradle 配置全局仓库（多模块项目适用）
对于包含多个子项目的 Gradle 构建，可在 settings.gradle 中统一配置仓库，避免每个 build.gradle 重复写：
// settings.gradle
pluginManagement {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
gradlePluginPortal() // Gradle 官方插件库
}
}
dependencyResolutionManagement {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
mavenCentral()
}
}
这样所有子项目自动继承仓库配置，build.gradle 中无需再写 repositories 块（除非要覆盖）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
