刚从Apache HttpClient转用Java 11自带的java.net.http.HttpClient时，我也纠结过怎么实现绑定特定出口接口的功能——毕竟之前用Apache的setLocalAddress太顺手了。其实Java HttpClient早就提供了对应的方案，下面给你一步步讲清楚：

核心方法：HttpClient.Builder.bindAddress() #

Java 11的HttpClient.Builder专门提供了bindAddress(InetAddress)方法，用来指定客户端发起请求时绑定的本地IP地址，这完全对应Apache HttpClient的setLocalAddress功能。

具体实现步骤 #

1. 获取要绑定的本地出口接口的InetAddress
   你可以通过两种方式获取目标地址：

   • 直接通过IP地址字符串获取：

     // 替换为你的出口接口IP
     InetAddress localAddr = InetAddress.getByName("192.168.1.100");
     

   • 通过网卡名称获取（适合有多网卡的场景）：

     // 替换为你的网卡名称，比如"eth1"、"wlan0"
     NetworkInterface networkInterface = NetworkInterface.getByName("eth1");
     // 获取网卡对应的第一个IP地址（按需调整）
     InetAddress localAddr = networkInterface.getInetAddresses().nextElement();
     

2. 创建绑定了指定地址的HttpClient
   在构建HttpClient时，调用bindAddress()传入刚才获取的本地地址即可：

   HttpClient client = HttpClient.newBuilder()
           .bindAddress(localAddr)
           .build();
   

完整示例代码 #

import java.net.InetAddress;
import java.net.NetworkInterface;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.util.Enumeration;

public class BoundHttpClientDemo {
    public static void main(String[] args) throws IOException, InterruptedException {
        // 方式1：通过IP地址绑定
        InetAddress localAddress = InetAddress.getByName("192.168.1.105");

        // 方式2：通过网卡名称绑定（注释掉方式1，打开下面代码即可）
        // NetworkInterface ni = NetworkInterface.getByName("wlan0");
        // Enumeration<InetAddress> addresses = ni.getInetAddresses();
        // InetAddress localAddress = addresses.nextElement();

        // 创建绑定了本地地址的HttpClient
        HttpClient client = HttpClient.newBuilder()
                .bindAddress(localAddress)
                .build();

        // 发起测试请求
        HttpRequest request = HttpRequest.newBuilder()
                .uri(java.net.URI.create("https://example.com"))
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println("请求状态码：" + response.statusCode());
        System.out.println("响应内容：" + response.body().substring(0, 100) + "...");
    }
}

注意事项 #

• 如果指定的InetAddress不可用（比如对应网卡未启用、IP不存在），构建HttpClient时会抛出IllegalArgumentException。
• 这个设置是客户端全局生效的：所有通过该HttpClient实例发起的请求，都会使用指定的本地地址绑定。如果需要不同请求用不同出口接口，需要创建多个HttpClient实例。
• 若使用代理，bindAddress指定的是客户端与代理服务器之间连接的本地绑定地址，而非客户端到目标服务器的地址，这和Apache HttpClient的行为保持一致。

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