Java配置代理下载依赖方法详解

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Java配置代理下载依赖教程》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

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）管理网络配置，比在命令行反复加参数更可靠。该文件默认不存在，需手动创建。

<settings>
  <proxies>
    <proxy>
      <id>my-proxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>127.0.0.1</host>
      <port>8888</port>
      <username>user</username>
      <password>pass</password>
      <nonProxyHosts>localhost|127.0.0.1|*.internal</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

• 必须为 true，否则不生效
• 写法与 JVM 参数一致，但不能用双引号包裹
• 如果只配了 http proxy，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 连不上中央仓库

常见原因不是参数写错，而是协议或路径被忽略：

• 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 不解析

代理配置真正麻烦的从来不是填几个字段，而是验证链路每一环是否支持 HTTPS tunnel、证书是否可信、非代理域名是否写对格式。尤其当多个工具（IDE、Maven、Gradle、Spring Boot DevTools）共存时，它们各自读取不同配置源，容易互相覆盖。

今天关于《Java配置代理下载依赖方法详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！