.NET 5.0控制台调用WebAPI遇SSL错误求助：无法确定帧大小

我来帮你分析并解决这个问题——你遇到的这个SSL连接错误在.NET 5.0早期RC版本里确实存在一些已知的TLS配置兼容性问题。

问题复现总结 #

• 环境：Windows 10企业版1809（内部版本17763.1518），.NET 5.0 RC2
• 操作与现象：
  1. 创建默认.NET 5.0 WebAPI项目，用Kestrel运行，Swagger首页和WeatherForecast接口调用均正常
  2. 新建.NET 5.0控制台应用，使用HttpClient调用该HTTPS接口时抛出错误
  3. 报错信息：

  System.Net.Http.HttpRequestException: The SSL connection could not be established, see inner exception. ---> System.IO.IOException: Cannot determine the frame size or a corrupted frame was received.

• 对比验证：Postman调用正常，将控制台项目切换为.NET Core 3.1后请求也正常，仅.NET 5.0控制台出现该问题

核心原因分析 #

.NET 5.0在TLS握手的默认配置上和.NET Core 3.1存在差异，尤其是RC2这类预发布版本，Kestrel的默认TLS协议集和控制台HttpClient的默认TLS支持版本可能不匹配；再加上Windows 10 1809的TLS底层支持和.NET 5.0的新设置存在兼容性冲突，最终导致SSL握手失败。

可尝试的解决方案 #

方案1：显式指定TLS协议版本 #

在控制台应用初始化HttpClient前，强制设置TLS版本为TLS 1.2（这是Kestrel在.NET 5.0中的主流默认值），确保两端协议匹配：

static async Task Main(string[] args)
{
    // 强制指定使用TLS 1.2协议
    System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

    var clientHandler = new HttpClientHandler 
    { 
        ServerCertificateCustomValidationCallback = (_, _, _, _) => true 
    };
    var client = new HttpClient(clientHandler);
    try
    {
        var httpMessage = await client.GetAsync("https://localhost:5001/WeatherForecast");
        httpMessage.EnsureSuccessStatusCode(); // 可选：验证响应状态
    }
    catch (Exception e)
    {
        Console.WriteLine(e);
        throw;
    }
}

方案2：升级到.NET 5.0正式版 #

RC版本属于预发布测试版，存在不少未修复的兼容性bug，官方在正式版中已经修复了大量TLS相关的问题，升级后大概率能解决该异常。

方案3：统一Kestrel与客户端的TLS配置 #

在WebAPI项目的Program.cs中，显式指定Kestrel支持的TLS协议，确保和控制台应用的配置对齐：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.ConfigureKestrel(serverOptions =>
            {
                serverOptions.ConfigureHttpsDefaults(httpsOptions =>
                {
                    // 指定Kestrel仅支持TLS 1.2
                    httpsOptions.SslProtocols = System.Security.Authentication.SslProtocols.Tls12;
                });
            });
            webBuilder.UseStartup<Startup>();
        });

额外验证建议 #

如果以上方案无效，可以尝试：

• 运行netsh winsock reset命令重置Windows的SSL缓存，重启电脑后再测试
• 检查Windows 10 1809的TLS服务是否正常开启（可在控制面板的Internet选项-高级中确认TLS 1.2已勾选）

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