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


  
    
      my-proxy
      true
      http
      127.0.0.1
      8888
      user
      pass
      localhost|127.0.0.1|*.internal
    
  
  • 必须为 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)共存时,它们各自读取不同配置源,容易互相覆盖。