0

0

在Java中如何配置代理环境下载依赖_Java网络环境设置说明

P粉602998670

P粉602998670

发布时间:2026-01-21 16:51:08

|

514人浏览过

|

来源于php中文网

原创

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

在java中如何配置代理环境下载依赖_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,其次才是系统级配置。推荐用前者,避免影响其他项目。

燕雀Logo
燕雀Logo

为用户提供LOGO免费设计在线生成服务

下载
  • 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.proxyUsersystemProp.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 不解析
代理配置真正麻烦的从来不是填几个字段,而是验证链路每一环是否支持 HTTPS tunnel、证书是否可信、非代理域名是否写对格式。尤其当多个工具(IDE、Maven、Gradle、Spring Boot DevTools)共存时,它们各自读取不同配置源,容易互相覆盖。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

841

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

742

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

738

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

399

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16926

2023.08.03

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

7

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.7万人学习

C# 教程
C# 教程

共94课时 | 7.2万人学习

Java 教程
Java 教程

共578课时 | 48.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号