httpclient设置本地代理服务器

在开发 Java 应用程序时，通过 HTTP Client 访问外部服务往往需要配置本地代理服务器，这通常用于企业内网环境、网络调试、安全过滤或绕过地域限制，根据使用的 HTTP 客户端库不同（如原生的 java.net.HttpURLConnection、Apache HttpClient 或 OkHttp），配置方式有所差异，以下将详细介绍几种主流方式的配置方法。

使用 JVM 系统属性配置（全局生效）

这是最简单且无需修改代码的方式,通过设置 JVM 启动参数，可以让所有基于 Java 网络库（包括 HttpURLConnection 和早期版本的 HttpClient）的请求都自动使用指定的代理。

配置参数说明：

使用方式：

在启动 Java 应用时添加参数：

或者在代码中动态设置（注意：这会影响整个 JVM 的所有后续网络请求）：

System.setProperty("http.proxyHost", "192.168.1.100"); System.setProperty("http.proxyPort", "8080"); System.setProperty("https.proxyHost", "192.168.1.100"); System.setProperty("https.proxyPort", "8080");

使用 Apache HttpClient 配置（推荐用于复杂场景）

Apache HttpClient 提供了更细粒度的控制，允许为特定的 HttpClient 实例配置代理，而不影响其他请求。

代码示例：

如果需要处理需要认证的代理服务器,可以在 HttpContext 中添加认证信息，或者使用 CredentialsProvider。

使用 OkHttp 配置

OkHttp 是现代 Android 和 Java 后端常用的 HTTP 客户端，其配置非常直观。

代码示例：

import okhttp3.OkHttpClient; import okhttp3.Request; import okhttp3.Response; import java.net.InetSocketAddress; import java.net.Proxy; public class OkHttpProxyExample { public static void main(String[] args) throws Exception { // 1. 定义代理类型和地址 Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("192.168.1.100", 8080)); // 2. 创建 OkHttpClient 实例并设置代理 OkHttpClient client = new OkHttpClient.Builder() .proxy(proxy) .build(); // 3. 构建请求 Request request = new Request.Builder() .url("https://www.example.com") .build(); // 4. 执行请求 try (Response response = client.newCall(request).execute()) { if (response.isSuccessful()) { System.out.println(response.body().string()); } } } }

使用 Java 11+ HttpClient 配置

Java 11 引入了新的 java.net.http.HttpClient，它支持异步和响应式编程，配置代理的方式如下：

代码示例：

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.ProxySelector; import java.net.InetSocketAddress; public class Java11HttpClientProxy { public static void main(String[] args) throws Exception { // 1. 定义代理地址 InetSocketAddress proxyAddress = new InetSocketAddress("192.168.1.100", 8080); // 2. 创建 HttpClient 并设置代理选择器 HttpClient client = HttpClient.newBuilder() .proxy(ProxySelector.of(proxyAddress)) .build(); // 3. 构建请求 HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://www.example.com")) .build(); // 4. 发送请求并获取响应 HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); } }

注意事项

1. 代理认证：如果代理服务器需要用户名和密码，上述代码示例中未直接展示，通常需要通过 Authenticator（对于 HttpURLConnection）或 CredentialsProvider（对于 Apache HttpClient）来配置。
2. 非代理主机：对于本地服务或内部域名，通常不需要经过代理，务必配置 http.nonProxyHosts 或使用路由规划器排除特定主机，以避免不必要的网络延迟或连接失败。
3. SSL/TLS 问题：使用代理时，特别是 HTTPS 请求，可能会遇到 SSL 证书验证问题，如果代理是中间人代理（MITM），可能需要导入代理的根证书到 Java 的信任库中。
4. 性能影响：代理服务器可能成为瓶颈，特别是在高并发场景下，请确保代理服务器有足够的带宽和处理能力。

相关问题与解答

问题 1：如何在 Apache HttpClient 中为需要认证的代理服务器配置用户名和密码？

解答：

在 Apache HttpClient 中，可以通过 CredentialsProvider 来配置代理认证，首先创建一个 CredentialsProvider 实例，然后添加代理的凭据，在构建 HttpClient 时，将这个 CredentialsProvider 设置进去，具体步骤如下：

1. 创建 BasicCredentialsProvider。
2. 使用 Credentials 接口（如 UsernamePasswordCredentials）定义用户名和密码。
3. 将凭据添加到 CredentialsProvider 中，指定主机、端口和认证方案（通常是 ProxyAuthScope）。
4. 在 HttpClients.custom() 中调用 .setDefaultCredentialsProvider(credentialsProvider)。

   这样，HttpClient 在发起请求时会自动携带代理认证信息。

问题 2：Java 11 的 HttpClient 是否支持动态切换代理？

解答：

是的，Java 11 的 HttpClient 支持动态切换代理。HttpClient.Builder 提供了 proxy(ProxySelector selector) 方法，你可以传入一个自定义的 ProxySelector 实现，在 ProxySelector.select(URI uri) 方法中，你可以根据请求的 URI、当前时间、负载情况或其他逻辑，动态返回不同的代理地址列表，你可以实现一个负载均衡的代理选择器，或者根据目标网站的不同返回不同的代理服务器，这种方式比硬编码代理地址更加灵活和强大。