系统代理在 OAuth2 RestTemplate 中失灵？揭开问题的根源和解决方案

系统代理设置未被 OAuth2 RestTemplate 调用正确使用：深入探讨问题及其解决方案

问题陈述

在使用 Spring Boot 和 OAuth2 的应用程序中，从远程应用程序设置系统代理对于访问后端 API 至关重要。然而，当 OAuth2 RestTemplate 调用 URL 时，代理设置未被正确应用，导致连接超时。

问题分析

深入分析后，我们发现 HttpURLConnection 类使用 InetSocketAddress 添加代理，但是当端口作为 Int 类型提供时，它不会正确解析。相反，端口必须作为字符串提供。

解决方案

为了解决此问题，我们需要确保将端口作为字符串而不是 Int 传递给 InetSocketAddress。这可以通过以下代码实现：

String httpsProxyHost = "myproxy.com";
String httpsProxyPort = "3000"; // 注意：端口应为字符串

// 设置系统属性
System.setProperty("https.proxyHost", httpsProxyHost);
System.setProperty("https.proxyPort", httpsProxyPort);

OAuth2 应用程序示例

在 Spring Boot OAuth2 应用程序中，我们可以通过以下方式在 Bean 后处理中设置代理：

@Configuration
public class ProxyConfig {

    @Bean
    @DependsOn("scopedTarget.oauth2ClientContext")
    public BeanPostProcessor restTemplateProxy() {
        return new BeanPostProcessor() {
            @Override
            public Object postProcessBeforeInitialization(Object bean, String beanName) {
                if (bean instanceof RestTemplate) {
                    RestTemplate restTemplate = (RestTemplate) bean;
                    ClientHttpRequestFactory requestFactory = restTemplate.getRequestFactory();
                    if (requestFactory instanceof HttpComponentsClientHttpRequestFactory) {
                        HttpComponentsClientHttpRequestFactory httpComponentsClientHttpRequestFactory = (HttpComponentsClientHttpRequestFactory) requestFactory;
                        httpComponentsClientHttpRequestFactory.setProxy(new HttpHost(proxyHost, proxyPort));
                    }
                }
                return bean;
            }
        };
    }
}

结论

通过将端口作为字符串传递给 InetSocketAddress，我们解决了系统代理设置未被 OAuth2 RestTemplate 正确使用的根本原因。这确保了远程应用程序能够正确访问后端 API，而不会遇到连接超时的问题。

常见问题解答

1. 为什么端口必须作为字符串而不是 Int？
   答：这是因为 InetSocketAddress 类的内部实现，它要求端口作为字符串以正确解析。

2. 除了端口之外，还需要设置哪些其他代理属性？
   答：除了端口之外，还需要设置代理主机。

3. 这种解决方案是否适用于其他 HTTP 库？
   答：这种解决方案仅适用于使用 HttpURLConnection 类或 HttpComponentsClientHttpRequestFactory 作为其底层 HTTP 库的 HTTP 库。

4. 在不修改 RestTemplate 的情况下，是否还有其他方法来设置代理？
   答：一种替代方法是在系统属性中设置代理设置，但这种方法可能会影响其他应用程序。

5. 这种解决方案是否与所有版本的 Spring Boot 兼容？
   答：该解决方案与大多数 Spring Boot 版本兼容，但建议使用较新版本以获得最佳支持。