Java命令行启动需用-Dhttp.proxyHost/-Dhttps.proxyHost等JVM参数显式配置代理,Maven通过settings.xml、Gradle通过gradle.properties配置,且HTTPS代理须单独设置,代理参数必须置于java命令最前。

Java命令行启动时如何传入代理参数
Java自身不读取系统代理或浏览器设置,必须显式通过 -Dhttp.proxyHost 和 -Dhttp.proxyPort 等 JVM 参数指定。Maven、Gradle 或直接运行 java -jar 下载依赖时都适用此方式。
- HTTP 代理:
-Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=8888 - HTTPS 代理(必须单独设):
-Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=8888 - 跳过代理的地址(如内网域名):
-Dhttp.nonProxyHosts="localhost|127.0.0.1|*.company.com",注意用竖线分隔,通配符仅支持*开头 - 若代理需认证,还需加:
-Dhttp.proxyUser=user -Dhttp.proxyPassword=pass(明文风险高,生产环境慎用)
Maven如何全局配置代理下载依赖
Maven 使用 ~/.m2/settings.xml(Windows 是 %USERPROFILE%\.m2\settings.xml)管理网络配置,比在命令行反复加参数更可靠。该文件默认不存在,需手动创建。
my-proxy true http 127.0.0.1 8888 user pass localhost|127.0.0.1|*.internal
-
必须为true,否则不生效 -
写法与 JVM 参数一致,但不能用双引号包裹 - 如果只配了
httpproxy,Maven 仍会尝试走 HTTPS 直连;需要 HTTPS 代理时,必须再定义一个块,设为https,且/指向同一代理服务(多数 HTTP 代理也支持 HTTPS tunnel)
Gradle项目中配置代理的两种方式
Gradle 优先读取项目根目录下的 gradle.properties,其次才是系统级配置。推荐用前者,避免影响其他项目。
- 在
gradle.properties中添加:systemProp.http.proxyHost=127.0.0.1 systemProp.http.proxyPort=8888 systemProp.https.proxyHost=127.0.0.1 systemProp.https.proxyPort=8888 systemProp.http.nonProxyHosts=localhost|127.0.0.1
- 若代理需认证,追加:
systemProp.http.proxyUser和systemProp.http.proxyPassword(同样明文存储) - 注意:Gradle 6.0+ 默认启用构建缓存和远程仓库校验,若代理拦截了 TLS 证书(如企业中间人代理),可能报
PKIX path building failed错误——此时需把代理 CA 证书导入 JVM truststore,不能仅靠代理参数解决
为什么设置了代理 still 连不上中央仓库
常见原因不是参数写错,而是协议或路径被忽略:
立即学习“Java免费学习笔记(深入)”;
- Maven 默认仓库地址是
https://repo.maven.apache.org/maven2/,但有些老旧镜像源仍用http://协议,而 JDK 8u111+ 默认禁用 HTTP,会导致连接拒绝。检查settings.xml中的URL 是否以https://开头 - 代理本身不支持 CONNECT 方法(例如某些 SOCKS 代理或简易 HTTP 转发),则无法建立 HTTPS tunnel,表现是
Connection refused或超时,而非认证失败 - 公司防火墙可能放行了 Maven Central,但封禁了其他仓库(如 JCenter 已关闭,部分项目残留配置会触发 403);建议先用
curl -x http://127.0.0.1:8888 https://repo.maven.apache.org/maven2/验证代理连通性 - JVM 参数必须加在
java命令最前面,写成java -jar app.jar -Dhttps.proxyHost=...是无效的——后面的是应用参数,JVM 不解析










