Xamarin Forms中HttpClient强制IPv4：ServicePoint方法无效求解决方案

问题背景 #

尝试通过ServicePointManager绑定回调的方式让HttpClient强制使用IPv4连接，该方案在.NET Framework 4.7中可正常触发回调，但在基于.NET Standard的Xamarin项目（属于.NET Core体系）中无效，回调无法触发。

原尝试代码：

var servicePoint = ServicePointManager.FindServicePoint(new Uri(uri));
servicePoint.BindIPEndPointDelegate = (servicePoint, remoteEndPoint, retryCount) =>
{
  if (remoteEndPoint.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
  {
    return new IPEndPoint(IPAddress.Any, 0);
  }

  throw new InvalidOperationException("no IPv4 address");
};

var _client = new HttpClient();
HttpResponseMessage response = await _client.GetAsync(uri);

可行解决方案 #

方案1：自定义HttpClientHandler实现请求级IPv4强制 #

通过自定义HttpClientHandler，手动解析域名的IPv4地址并替换请求Uri，同时保留Host头以确保服务器正确识别请求：

public class IPv4HttpClientHandler : HttpClientHandler
{
    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var host = request.RequestUri.Host;
        // 解析域名对应的IPv4地址
        var ipAddresses = await Dns.GetHostAddressesAsync(host);
        var ipv4Address = ipAddresses.FirstOrDefault(ip => ip.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork);

        if (ipv4Address == null)
        {
            throw new InvalidOperationException("未找到目标域名的IPv4地址");
        }

        // 构建使用IPv4地址的新Uri
        var uriBuilder = new UriBuilder(request.RequestUri)
        {
            Host = ipv4Address.ToString()
        };
        request.RequestUri = uriBuilder.Uri;

        // 添加Host头，保证服务器能正确处理域名路由
        request.Headers.Host = host;

        return await base.SendAsync(request, cancellationToken);
    }
}

使用示例：

// 实例化带自定义Handler的HttpClient
var httpClient = new HttpClient(new IPv4HttpClientHandler());
var response = await httpClient.GetAsync(uri);

方案2：全局设置强制优先IPv4 #

针对.NET Core 3.1及以上版本（含Xamarin基于的.NET Standard），可通过AppContext全局开关强制所有网络请求优先使用IPv4：

// 在应用启动阶段设置（如App.xaml.cs的OnStart方法）
AppContext.SetSwitch("System.Net.DisableIPv6", true);

注意：该设置为全局生效，会影响应用内所有网络请求。如果仅需部分请求强制IPv4，建议使用方案1。

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