在当今的企业级开发环境中，出于安全与合规考量，许多组织采用了严格的网络访问策略。开发者在日常构建中，无论是下载依赖还是运行集成测试，常常需要通过HTTP代理来访问外部资源。然而，当使用Gradle作为构建工具时，一个看似简单的问题却令不少团队头疼不已——如何将HTTP代理配置正确地传递给Gradle的测试执行器（Test Executor）？本文将深入解析这一问题，并提供全面的解决方案。

代理传递的“最后一公里”

Gradle本身支持通过系统属性（如http.proxyHost、http.proxyPort）来配置HTTP代理。通常，开发者可以在gradle.properties文件中设置这些属性，或者在命令行使用-D参数传递。这些设置对于下载依赖（如通过Maven仓库）是有效的。然而，当测试任务启动时，Gradle的测试执行器是以独立子进程方式运行的，它默认不会继承Gradle守护进程（Daemon）或JVM的系统属性。这意味着，即便你为Gradle配置了代理，测试代码中通过System.getProperty()读取代理相关属性时，很可能得到的是null，导致网络请求失败。

痛点场景：被阻断的外网测试

某金融科技公司的DevOps团队近期就遭遇了类似问题：他们的一套微服务项目需要在CI流水线中运行集成测试，测试用例会调用第三方支付接口（需通过公司代理）。尽管在gradle.properties中配置了systemProp.http.proxyHost=proxy.company.com，但测试任务始终报连接超时。调试发现，测试进程内的http.proxyHost属性根本不存在。这一问题在多个Java项目中反复出现，严重影响了交付效率。

解决方案：显式传递代理属性

要解决这一“属性断层”，核心思路是主动将系统属性传递给测试执行器的JVM。Gradle提供了多种实现手段，以下是几种主流且可靠的方法。

方法一：使用Test任务的jvmArgs配置

最直接的方式是在build.gradle文件中，为test任务显式添加JVM参数。示例代码如下：

test {
    // 从Gradle JVM获取代理系统属性，并传递给测试子进程
    systemProperties System.getProperties().subMap([
        "http.proxyHost", "http.proxyPort", "http.proxyUser",
        "http.proxyPassword", "https.proxyHost", "https.proxyPort",
        "https.proxyUser", "https.proxyPassword",
        "http.nonProxyHosts", "https.nonProxyHosts"
    ]).findAll { it.value != null }

    // 或者更简洁地：直接传递所有以"proxy"开头的系统属性
    jvmArgs System.getProperties().findAll { 
        it.key.startsWith("proxy") || it.key.startsWith("http.proxy") || it.key.startsWith("https.proxy")
    }.collect { "-D${it.key}=${it.value}" }
}

此方法利用了Gradle的systemProperties配置，它的作用域仅限于测试任务，不会影响其他构建阶段。

方法二：利用gradle.properties中的统一配置

在项目根目录的gradle.properties文件中添加以下内容，可以让Gradle自动在测试任务中使用相同的代理设置：

systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=8080
systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=8080
systemProp.http.nonProxyHosts=localhost|127.*|10.*|*.company.com

然后在build.gradle中读取这些属性并传递给测试：

test {
    // 读取gradle.properties中定义的systemProp.*
    def proxyKeys = ["http.proxyHost", "http.proxyPort", "https.proxyHost", "https.proxyPort", "http.nonProxyHosts"]
    proxyKeys.each { key ->
        def value = System.getProperty(key)
        if (value != null) {
            systemProperty key, value
        }
    }
}

这种方式将配置与代码分离，更便于环境适配。

方法三：全局配置通过环境变量

对于CI/CD流水线，更推荐使用环境变量来注入代理信息。例如在Jenkins或GitLab CI中设置环境变量，然后在gradle.properties或构建脚本中读取。这样，代理配置无需硬编码在代码仓库中。

# 在CI环境中设置
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1,*.company.com

Gradle脚本中可通过System.env获取并转换。

避坑指南：常见错误与最佳实践

  1. 不要忘记https代理：很多应用同时使用HTTP和HTTPS协议，务必同时配置https.proxyHost等属性。
  2. 密码安全：如果代理需要认证，避免将用户名密码硬编码在属性文件中。可使用CI的Secret功能或Gradle的-P参数动态传入。
  3. 排除内部域名：务必通过http.nonProxyHosts设置不经过代理的内部地址，否则会导致内网请求异常。
  4. 测试子进程的JVM参数优先级：通过jvmArgs设置的参数优先级高于gradle.properties中的systemProp，注意不要覆盖其他必要的JVM参数。

结语：从被动堵漏到主动治理

将HTTP代理系统属性传递给Gradle测试执行器，本质上是一场关于进程上下文隔离的认知战。通过显式配置test.systemProperties或利用Gradle的jvmArgs，开发者能够轻松打通企业网络屏障，让测试代码在受限环境中也能正常访问外部服务。当前，不少大型团队已经将这套方案纳入标准化构建模板，实现了“一次配置，处处运行”。

随着K8s和容器化部署的普及，代理配置的管理方式还在持续演进。但理解底层原理——如何跨越Gradle守护进程与测试子进程之间的属性鸿沟，依然是每一位Java/Android开发者必备的调优技能。只有掌握了这些“最后一公里”的细节，才能真正实现流畅的自动化构建与交付。