Xamarin Forms调用HTTPS API遇SSL连接异常求解决（PCL/.NET4.5）

问题背景 #

基于Xamarin Forms开发的移动应用，原HTTP API调用正常，API迁移至HTTPS后出现SSL异常。项目采用PCL格式，目标框架为.NET Framework 4.5，无法直接使用ServicePointManager或HttpClientHandler.ServerCertificateCustomValidationCallback。当前HttpClient初始化代码如下：

private HttpClient GetClient(HttpClientHandler handler = null)
{
    try
    {
        IProxyInfoProvider _proxyInfoProvider = DependencyService.Get<IProxyInfoProvider>();
        HttpClientHandler handlerClient = new HttpClientHandler()
        {
            Proxy = _proxyInfoProvider.GetProxySettings()
        };
        handlerClient.UseProxy = true;
        //ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;
        // handlerClient.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator;
        HttpClient client = new HttpClient(handlerClient);
        return client;
    }
    catch (Exception ex)
    {
        throw;
    }
}

可行解决办法 #

由于PCL层无法直接处理平台特定的SSL验证逻辑，需通过Xamarin DependencyService在各原生平台实现自定义证书处理，再在PCL层调用：

1. 定义PCL层接口 #

先在PCL核心项目中定义统一接口，用于获取平台特定的HttpClientHandler：

public interface ICertificateHandler
{
    HttpClientHandler GetCustomHandler();
}

2. Android平台实现 #

在Android项目中创建接口实现类，利用AndroidClientHandler处理证书验证：

[assembly: Dependency(typeof(AndroidCertificateHandler))]
namespace YourAppNamespace.Droid
{
    public class AndroidCertificateHandler : ICertificateHandler
    {
        public HttpClientHandler GetCustomHandler()
        {
            var androidHandler = new Xamarin.Android.Net.AndroidClientHandler();
            // 自定义证书验证逻辑（示例为临时绕过，生产环境需替换为严格校验）
            androidHandler.ServerCertificateCustomValidationCallback = (requestMessage, certificate, chain, sslErrors) =>
            {
                // 示例：校验证书指纹或颁发机构，此处仅为测试用
                return true;
            };
            return androidHandler;
        }
    }
}

3. iOS平台实现 #

在iOS项目中创建接口实现类，使用NSUrlSessionHandler处理证书验证：

[assembly: Dependency(typeof(IOSCertificateHandler))]
namespace YourAppNamespace.iOS
{
    public class IOSCertificateHandler : ICertificateHandler
    {
        public HttpClientHandler GetCustomHandler()
        {
            var iosHandler = new NSUrlSessionHandler();
            // 自定义证书验证逻辑（示例为临时绕过，生产环境需替换为严格校验）
            iosHandler.ServerCertificateCustomValidationCallback = (requestMessage, certificate, chain, sslErrors) =>
            {
                // 示例：校验证书指纹或颁发机构，此处仅为测试用
                return true;
            };
            return iosHandler;
        }
    }
}

4. 修改PCL层HttpClient初始化代码 #

更新原GetClient方法，通过DependencyService获取平台Handler并配置代理：

private HttpClient GetClient(HttpClientHandler handler = null)
{
    try
    {
        IProxyInfoProvider _proxyInfoProvider = DependencyService.Get<IProxyInfoProvider>();
        // 获取平台自定义证书Handler
        var customHandler = DependencyService.Get<ICertificateHandler>().GetCustomHandler();
        
        // 配置代理
        customHandler.Proxy = _proxyInfoProvider.GetProxySettings();
        customHandler.UseProxy = true;
        
        HttpClient client = new HttpClient(customHandler);
        return client;
    }
    catch (Exception ex)
    {
        throw;
    }
}

关键注意事项 #

• 测试与生产环境区分：示例中return true是临时绕过证书验证，仅用于测试调试。生产环境必须实现严格的证书校验逻辑，比如验证证书的域名匹配、颁发机构合法性、有效期等，防止中间人攻击。
• 优先保证证书合法性：优先确保HTTPS服务器使用正规CA颁发的可信证书，这是从根源解决SSL异常的最佳方案，自定义验证仅作为特殊场景的补充。

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