配置代理和镜像仓库可解决Gradle构建时的网络问题。首先在~/.gradle/gradle.properties中设置HTTP/HTTPS代理，包括host、port及认证信息；然后在build.gradle中将mavenCentral()替换为阿里云等国内镜像源，如https://maven.aliyun.com/repository/public；为避免重复，可通过~/.gradle/init.gradle全局配置，自动重定向中央仓库至镜像地址，提升多项目构建效率与稳定性。
在使用Gradle构建Java项目时，网络问题常常导致依赖下载失败。尤其是在国内或企业内网环境中，配置代理和更换为国内镜像仓库是提升构建效率的关键步骤。下面介绍如何正确配置Gradle的代理和仓库，确保项目顺利构建。
配置HTTP/HTTPS代理
如果开发环境需要通过代理访问外网，必须在Gradle中设置代理参数。这些配置通常放在用户目录下的gradle.properties文件中（路径如：~/.gradle/gradle.properties）。
添加以下内容以启用代理：
- systemProp.http.proxyHost=your.proxy.host
- systemProp.http.proxyPort=8080
- systemProp.https.proxyHost=your.proxy.host
- systemProp.https.proxyPort=8080
若代理需要认证，继续添加用户名和密码：
立即学习“Java免费学习笔记（深入）”；
- systemProp.http.proxyUser=username
- systemProp.http.proxyPassword=password
- systemProp.https.proxyUser=username
- systemProp.https.proxyPassword=password
配置完成后，Gradle发起的网络请求将通过指定代理进行，解决连接超时或拒绝访问的问题。
更换为国内镜像仓库
默认情况下，Gradle从Maven Central下载依赖，但该地址在国外，速度较慢。可以通过修改项目的build.gradle文件，替换为国内镜像源。
例如，使用阿里云Maven镜像：
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
mavenCentral()
}
或将mavenCentral()直接替换为：
maven { url 'https://maven.aliyun.com/repository/central' }
其他常用镜像还包括腾讯云、华为云等提供的Maven服务，选择响应快且稳定的即可。
全局配置避免重复设置
如果你有多个项目都需要相同配置，可以在~/.gradle/init.gradle中定义全局仓库和代理策略，减少每个项目重复编写。
创建或编辑init.gradle文件，加入：
allprojects {
repositories {
all { ArtifactRepository repo ->
if(repo instanceof MavenArtifactRepository){
def url = repo.url.toString()
if (url.startsWith('https://repo1.maven.org/maven2') ||
url.startsWith('https://jcenter.bintray.com')) {
project.repositories.remove(repo)
project.repositories.maven {
url "https://maven.aliyun.com/repository/public"
}
}
}
}
}
}
这样所有项目在构建时会自动将中央仓库重定向到阿里云镜像。
基本上就这些。合理配置代理和仓库能显著提升Gradle构建速度与稳定性，特别是在网络受限环境下尤为重要。配置不复杂但容易忽略细节，建议团队统一规范，避免因环境差异导致构建失败。
