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，否则不生效 -
- 如果只配了
httpproxy，Maven 仍会尝试走 HTTPS 直连；需要 HTTPS 代理时，必须再定义一个https，且
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中的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 大师之旅：从入门到精通的终极指南
