如何在Xamarin Android中调用自签名SSL的API并解决握手异常问题

报错信息：
Javax.Net.Ssl.HandshakeException:
java.security.cert.CertPathValidatorException: Trust anchor for certification path not found

该异常是因为Android系统默认不信任未被权威CA机构签发的自签名证书，缺少可信任的证书锚点导致SSL握手失败，可通过以下方案解决：

方案1：开发阶段临时绕过校验（仅可用于本地测试，禁止线上使用） #

如果仅需快速验证接口功能，可配置HttpClient跳过所有证书校验：

• 自定义请求处理器逻辑：

var httpClientHandler = new HttpClientHandler
{
    ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) =>
    {
        // 直接返回true跳过所有证书校验，仅本地测试可用
        return true;
    }
};
var httpClient = new HttpClient(httpClientHandler);

注意：该方案存在严重的中间人攻击风险，绝对不能用于生产环境

方案2：生产环境配置内置信任自签名证书（推荐） #

将自签名证书内置到应用中，仅信任指定的证书，兼顾安全性和兼容性：

• 第一步：将你的自签名证书文件（格式为.cer/.pem）放到Xamarin Android项目的Assets目录下，右键证书文件设置生成操作为AndroidAsset
• 第二步：编写证书校验逻辑，代码示例：

// 读取Assets目录下的自签名证书
using var certStream = Android.App.Application.Context.Assets.Open("your_custom_cert.cer");
var trustedCert = new X509Certificate2(certStream);

var httpClientHandler = new HttpClientHandler();
httpClientHandler.ServerCertificateCustomValidationCallback = (sender, receivedCert, chain, sslPolicyErrors) =>
{
    // 无证书错误直接通过
    if (sslPolicyErrors == SslPolicyErrors.None)
        return true;
    // 校验返回的证书是否和内置的自签名证书一致
    return receivedCert.GetRawCertDataString() == trustedCert.GetRawCertDataString();
};
var httpClient = new HttpClient(httpClientHandler);

• 如果你使用原生Android的HttpURLConnection发起请求，可自定义X509TrustManager将自签名证书加入信任锚点即可适配。

额外适配说明 #

• Android 7.0及以上版本默认不信任用户手动安装到系统的CA证书，如果你采用将证书安装到设备信任区的方案，需要在AndroidManifest.xml的application节点添加配置android:networkSecurityConfig="@xml/network_security_config"，指定信任的证书规则。
• 条件允许的情况下优先使用权威CA机构签发的公开SSL证书，无需额外配置即可被所有设备信任，安全性和兼容性最优。

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