如何在Apache HttpClient 5中为单个请求配置代理？

当然可以在请求级别配置代理，无需全局修改HttpClient。以下是两种实用的实现方式：

方法一：通过请求上下文指定代理 #

利用HttpClientContext为单个请求绑定专属代理，其他请求不受影响：

// 创建无默认代理的全局HttpClient实例
CloseableHttpClient httpClient = HttpClients.createDefault();

// 定义需要使用代理的请求
HttpGet proxyRequest = new HttpGet("https://your-target-url.com");

// 配置目标代理
HttpHost proxyHost = new HttpHost("proxy.example.com", 8080);

// 创建请求上下文并设置代理属性
HttpClientContext requestContext = HttpClientContext.create();
requestContext.setAttribute(HttpClientContext.HTTP_PROXY, proxyHost);

// 发送请求时传入上下文，仅该请求使用代理
try (CloseableHttpResponse response = httpClient.execute(proxyRequest, requestContext)) {
    // 处理响应逻辑
    System.out.println(response.getCode());
} catch (IOException e) {
    e.printStackTrace();
}

// 普通请求（不传入上下文，无代理）
HttpGet normalRequest = new HttpGet("https://another-target-url.com");
try (CloseableHttpResponse response = httpClient.execute(normalRequest)) {
    // 处理普通响应
}

这种方式直接轻量，适合简单的单请求代理场景。

方法二：自定义路由规划器实现动态代理 #

如果需要更灵活的代理规则（比如根据请求属性选择不同代理），可以自定义HttpRoutePlanner，结合请求的自定义属性动态决定代理逻辑：

// 自定义路由规划器，根据请求属性判断是否使用代理
HttpRoutePlanner customRoutePlanner = new SystemDefaultRoutePlanner(ProxySelector.getDefault()) {
    @Override
    public HttpRoute determineRoute(HttpHost target, HttpRequest request, HttpContext context) throws HttpException {
        // 从请求属性中获取代理配置
        HttpHost assignedProxy = (HttpHost) request.getAttribute("REQUEST_SPECIFIC_PROXY");
        if (assignedProxy != null) {
            // 为该请求构建带代理的路由
            return new HttpRoute(target, null, assignedProxy, false);
        }
        // 无代理配置时使用默认路由逻辑
        return super.determineRoute(target, request, context);
    }
};

// 创建使用自定义路由规划器的HttpClient
CloseableHttpClient httpClient = HttpClients.custom()
        .setRoutePlanner(customRoutePlanner)
        .build();

// 无代理请求：无需设置任何属性
HttpGet normalRequest = new HttpGet("https://normal-url.com");
httpClient.execute(normalRequest);

// 带代理请求：设置自定义属性指定代理
HttpGet proxyRequest = new HttpGet("https://proxy-required-url.com");
proxyRequest.setAttribute("REQUEST_SPECIFIC_PROXY", new HttpHost("proxy.example.com", 8080));
httpClient.execute(proxyRequest);

关于弃用的setProxy()方法 #

虽然RequestConfig.Builder.setProxy()被标记为弃用，但在当前HttpClient 5.x版本中仍可正常使用。不过官方更推荐上述路由规划器或请求上下文的方式，因为它们能支持更复杂的路由决策逻辑。

内容的提问来源于stack exchange，提问作者Óscar