如何配置Java 11/17 HttpClient尝试主机名关联的多个IP地址？

问题背景 #

默认情况下，Java 9/11/17自带的HttpClient只会尝试主机名解析后返回的第一个IP地址，若该地址不可达则直接请求失败。但以下两种场景需要客户端自动尝试所有可用IP：

• 同时支持IPv4和IPv6的服务器：例如localhost解析后同时返回127.0.0.1和::1，若服务仅绑定其中一种协议，客户端需自动尝试另一个IP
• 多冗余服务器的逻辑主机名：例如frontend.example.com对应多个IPv4/IPv6地址，部分服务器故障时，客户端需尝试其他可用节点

场景解析示例 #

场景1：localhost解析结果

> host localhost
localhost has address 127.0.0.1
localhost has IPv6 address ::1

场景2：多节点主机解析结果

> host frontend.example.com
frontend.example.com has address 245.3.4.5
frontend.example.com has address 246.4.5.6
frontend.example.com has IPv6 address 4f00:5678::19
frontend.example.com has IPv6 address 4f00:7890::20

需求目标：让HttpClient遍历InetAddress.getAllByName()获取的所有IP，直到找到可用服务器，仅当所有IP都失败时才返回连接错误。

实现方案 #

方法1：手动遍历所有IP并尝试请求 #

这种方式直观可控，先解析目标主机的所有IP，再逐个构建请求（替换URI主机为IP并保留原Host头），直到请求成功。

示例代码：

import java.net.URI;
import java.net.InetAddress;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class MultiIpHttpClient {
    // 初始化全局HttpClient实例
    private static final HttpClient HTTP_CLIENT = HttpClient.newHttpClient();

    public static HttpResponse<String> sendRequestWithMultiIp(String originalUri) throws Exception {
        URI uri = URI.create(originalUri);
        String targetHost = uri.getHost();
        // 处理默认端口（HTTP为80，HTTPS为443）
        int targetPort = uri.getPort() == -1 
                ? (uri.getScheme().equals("https") ? 443 : 80) 
                : uri.getPort();
        String requestPath = uri.getRawPath() + (uri.getRawQuery() != null ? "?" + uri.getRawQuery() : "");

        // 获取目标主机的所有IP地址
        InetAddress[] allAddresses = InetAddress.getAllByName(targetHost);

        Exception lastFailedException = null;
        for (InetAddress addr : allAddresses) {
            try {
                // 构建基于IP的请求URI
                URI ipTargetUri = new URI(
                        uri.getScheme(),
                        null,
                        addr.getHostAddress(),
                        targetPort,
                        requestPath,
                        null,
                        null
                );

                // 构建请求，必须设置Host头以匹配服务器域名配置
                HttpRequest request = HttpRequest.newBuilder(ipTargetUri)
                        .setHeader("Host", targetHost)
                        .build();

                HttpResponse<String> response = HTTP_CLIENT.send(request, HttpResponse.BodyHandlers.ofString());
                // 仅当请求成功（2xx状态码）时返回结果
                if (response.statusCode() >= 200 && response.statusCode() < 300) {
                    return response;
                }
            } catch (Exception e) {
                lastFailedException = e;
                System.err.printf("连接IP %s 失败: %s%n", addr.getHostAddress(), e.getMessage());
            }
        }

        // 所有IP尝试失败，抛出最后一次异常
        throw lastFailedException != null 
                ? lastFailedException 
                : new RuntimeException("目标主机 " + targetHost + " 无可用IP地址");
    }

    public static void main(String[] args) throws Exception {
        // 示例：请求本地服务
        HttpResponse<String> response = sendRequestWithMultiIp("http://localhost:8080/api");
        System.out.println("请求响应: " + response.body());
    }
}

方法2：自定义DnsResolver结合重试策略（进阶） #

Java HttpClient默认的InetAddressDnsResolver已会返回所有IP，但连接逻辑仅尝试第一个。若需通过客户端配置实现自动重试，可自定义DnsResolver确保IP顺序符合需求，再配合自定义重试逻辑（需扩展HttpRequest或使用Executor处理重试）。不过这种方式复杂度较高，手动遍历的方案更易维护。

关键注意事项 #

• HTTPS请求处理：直接用IP访问HTTPS服务会触发证书域名不匹配问题，测试环境可临时跳过验证（生产环境禁用）：

  HttpClient httpClient = HttpClient.newBuilder()
          .hostnameVerifier((hostname, session) -> true) // 跳过域名验证
          .build();
  

  生产环境需确保服务器证书包含对应IP，或配置自定义SSLContext信任该IP的证书。
• IP尝试顺序：可根据需求调整IP遍历顺序，比如优先IPv4/IPv6，或通过网络延迟检测排序后再尝试。

内容的提问来源于stack exchange，提问作者Dirk Hillbrecht