.NET 7 MAUI调用REST API无法接收HTTP响应问题求助

错误核心原因 #

你遇到的System.Net.Security.SslPolicyErrors.RemoteCertificateChainErrors和RemoteCertificateNameMismatch，本质是两个问题：

• 服务器证书的信任链不被MAUI客户端认可（比如自签名证书、中间证书缺失）
• 请求的URL域名与证书上的通用名称（CN）/主题备用名称（SAN）不匹配

Postman和SwaggerUI默认会跳过部分证书验证逻辑，所以能正常请求，但MAUI客户端默认严格遵循SSL验证规则，导致请求被阻断。

排查与修复步骤 #

1. 验证请求域名与证书的匹配性 #

• 检查AndroidBaseURL的配置值，确认其域名/IP与服务器证书的CN字段或SAN扩展完全一致。比如证书CN是api.yourdomain.com，但你用192.168.1.100或localhost请求，必然触发NameMismatch错误。
• 可以通过浏览器访问API地址，查看证书详情确认域名信息。

2. 修复证书验证逻辑的漏洞 #

你的HttpsClientHandlerService中，Android端仅信任CN=localhost的证书，若你的API不是localhost环境，这个逻辑完全不生效，导致验证失败。根据环境调整验证规则：

调试环境临时放宽验证（仅限开发阶段）

#if ANDROID
var handler = new Xamarin.Android.Net.AndroidMessageHandler();
handler.ServerCertificateCustomValidationCallback = (message, cert, chain, errors) =>
{
#if DEBUG
    // 调试环境跳过证书验证，生产环境必须删除此逻辑
    return true;
#else
    return errors == System.Net.Security.SslPolicyErrors.None;
#endif
};
return handler;
#endif

生产/测试环境信任特定自签名证书

如果使用自签名证书，建议通过证书指纹精准信任，避免全局放宽：

#if ANDROID
var handler = new Xamarin.Android.Net.AndroidMessageHandler();
handler.ServerCertificateCustomValidationCallback = (message, cert, chain, errors) =>
{
    // 替换为你的自签名证书SHA-256指纹
    const string allowedThumbprint = "A1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B2";
    if (cert != null && cert.Thumbprint.Equals(allowedThumbprint, StringComparison.OrdinalIgnoreCase))
        return true;
    return errors == System.Net.Security.SslPolicyErrors.None;
};
return handler;
#endif

3. 修正URL构建逻辑 #

Path.Combine是为本地文件路径设计的，拼接URL可能导致斜杠异常（比如BaseURL末尾无斜杠时，会错误合并路径），改用Uri原生拼接：

private Uri BuildUri(string route)
{
    var baseUri = new Uri(BaseURL);
    return new Uri(baseUri, $"{settings.ApiVersion}/{route.TrimStart('/')}");
}

private Uri BuildUri(string route, object routParam)
{
    var baseUri = new Uri(BaseURL);
    return new Uri(baseUri, $"{settings.ApiVersion}/{route.TrimStart('/')}/{routParam}");
}

4. 完善异常捕获逻辑 #

当前代码仅抛出ex.Message，丢失了原始异常的堆栈和详细SSL错误信息，不利于排查：

catch (Exception ex)
{
    // 保留内部异常，便于追踪根因
    throw new Exception($"请求{route}失败", ex);
}

额外检查点 #

• 确认AndroidManifest.xml中添加了网络权限：<uses-permission android:name="android.permission.INTERNET" />
• 若API部署在本地局域网，检查设备与服务器是否在同一网络，且防火墙未拦截请求

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