Docker容器内Java应用通过企业代理调用Webservice失败求助

我之前也碰到过几乎一模一样的问题——Docker容器里curl能正常通代理访问目标服务，但Java代码用RestTemplate调用就死活连不上。结合我的踩坑经验，大概率是这几个环节没处理对，给你一步步梳理解决方案：

1. 先区分HTTP/HTTPS，别漏设对应代理属性 #

你只设置了http.proxyHost和http.proxyPort，但如果目标Webservice是HTTPS协议的话，Java会忽略HTTP代理配置，必须单独设置HTTPS的系统属性：

// 针对HTTP请求
System.setProperty("http.proxyHost", "myproxyhost");
System.setProperty("http.proxyPort", "8080");
// 针对HTTPS请求，必须单独配置
System.setProperty("https.proxyHost", "myproxyhost");
System.setProperty("https.proxyPort", "8080");

⚠️ 注意：一定要在初始化RestTemplate之前设置这些系统属性，否则RestTemplate已经创建完成，不会读取后续修改的属性。

2. 显式给RestTemplate配置代理（最可靠的方案） #

如果你的RestTemplate是自定义构建的（比如用new RestTemplate()），仅仅设置系统属性可能不生效——因为有些ClientHttpRequestFactory实现不会自动读取系统代理配置。这时候最好直接给RestTemplate绑定代理工厂：

方案A：用SimpleClientHttpRequestFactory（适合简单场景） #

// 1. 创建代理地址
InetSocketAddress proxyAddress = new InetSocketAddress("myproxyhost", 8080);
// 2. 配置请求工厂
SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
requestFactory.setProxy(proxyAddress);
// 3. 绑定到RestTemplate
RestTemplate restTemplate = new RestTemplate(requestFactory);

方案B：用HttpComponentsClientHttpRequestFactory（支持代理认证、HTTPS更稳定） #

如果企业代理需要用户名密码认证，或者你需要更灵活的HTTP配置，推荐用Apache HttpComponents的实现：

// 1. 配置代理认证（如果需要的话）
CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
credentialsProvider.setCredentials(
        new AuthScope("myproxyhost", 8080),
        new UsernamePasswordCredentials("你的代理用户名", "你的代理密码")
);
// 2. 创建带代理的HttpClient
HttpClient httpClient = HttpClientBuilder.create()
        .setDefaultCredentialsProvider(credentialsProvider)
        .setProxy(new HttpHost("myproxyhost", 8080))
        .build();
// 3. 绑定到RestTemplate
HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
RestTemplate restTemplate = new RestTemplate(requestFactory);

3. 检查Docker容器的代理环境变量是否传递给Java进程 #

你已经给Docker客户端和容器配了代理，但Java进程可能没正确读取到这些环境变量。可以在启动容器时显式传入代理环境变量：

docker run -d \
  -e HTTP_PROXY=http://myproxyhost:8080 \
  -e HTTPS_PROXY=http://myproxyhost:8080 \
  -e NO_PROXY=localhost,127.0.0.1,内部服务域名 \
  --name myContainer \
  你的镜像名

然后在Java代码里读取这些环境变量来配置代理，比硬编码更灵活：

String httpProxy = System.getenv("HTTP_PROXY");
if (httpProxy != null) {
    String[] proxyParts = httpProxy.replace("http://", "").split(":");
    String proxyHost = proxyParts[0];
    int proxyPort = Integer.parseInt(proxyParts[1]);
    // 然后用上面的方法配置RestTemplate的代理
}

4. 验证代理配置是否生效 #

可以在代码里打印当前的系统属性和RestTemplate的配置，确认是否正确：

// 打印系统属性
System.out.println("http.proxyHost: " + System.getProperty("http.proxyHost"));
System.out.println("https.proxyHost: " + System.getProperty("https.proxyHost"));
// 打印RestTemplate的请求工厂配置
RestTemplate restTemplate = new RestTemplate();
Object factory = restTemplate.getRequestFactory();
if (factory instanceof SimpleClientHttpRequestFactory) {
    System.out.println("Proxy set: " + ((SimpleClientHttpRequestFactory) factory).getProxy());
}

按照这个顺序排查，基本能解决问题——我当时就是因为忽略了HTTPS代理的单独配置，折腾了半天😂

内容的提问来源于stack exchange，提问作者Harry K