Xamarin.Forms UWP端设置HttpClientHandler.MaxConnectionsPerServer为1报错

这个问题的核心在于UWP平台上HttpClientHandler的底层实现和ASP.NET Core完全不同，导致了配置规则的差异：

为什么会报错？ #

在UWP环境中，.NET的HttpClientHandler其实是对UWP原生的Windows.Web.Http.Filters.HttpBaseProtocolFilter的包装。而这个原生类的MaxConnectionsPerServer属性有一个硬性限制：最小值为2，当你尝试设置为1时，就会触发ArgumentException（错误信息"Wrong parameter value"正是来自UWP原生API的抛出）。

而在ASP.NET Core环境中，HttpClientHandler使用的是.NET自身的HTTP栈实现，它允许将MaxConnectionsPerServer设置为1，这就是两个平台行为不一致的根本原因。

解决办法 #

根据你的需求（仅需单连接），可以按以下方式处理：

1. 平台差异化配置
   既然UWP不允许设置为1，我们可以通过平台条件编译，给不同平台设置对应的值：

   var handler = new HttpClientHandler();
   #if WINDOWS_UWP
       // UWP平台最小值为2，这里设置为2
       handler.MaxConnectionsPerServer = 2;
   #else
       // iOS/Android/ASP.NET Core平台设置为1
       handler.MaxConnectionsPerServer = 1;
   #endif
   

2. 如果必须严格单连接（UWP端）
   如果你在UWP端必须确保只有一个连接，可以直接使用UWP原生的HttpBaseProtocolFilter和Windows.Web.Http.HttpClient，同时通过保持单个HttpClient实例的方式来实现连接复用（因为HttpClient默认会复用连接池中的连接，只要你不频繁创建新实例，就能保证同一服务器只有一个活跃连接）：

   // 在UWP端使用原生API
   var filter = new Windows.Web.Http.Filters.HttpBaseProtocolFilter();
   // 虽然不能设为1，但保持单个HttpClient实例就能复用连接
   var httpClient = new Windows.Web.Http.HttpClient(filter);
   // 全局复用这个httpClient实例，不要每次请求都新建
   

3. 验证连接复用效果
   无论使用哪种方式，确保你的HttpClient实例是全局复用的（不要在每次请求时创建新的HttpClient），这不仅能保证连接复用，还能避免socket资源泄漏的问题。

补充说明 #

微软官方文档中可能没有明确标注这个跨平台的配置差异，所以很容易踩坑。记住：在Xamarin.Forms的不同平台上，某些.NET API的底层实现可能依赖于原生平台的API，它们的行为规则可能和纯.NET环境不一致。

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