Blazor Server调用第三方API本地TLS认证失败，Azure正常求排查

开发了一个Blazor Server应用，通过IHttpClientFactory调用第三方API。本地Windows 11机器执行调用时出现SSL连接异常，但部署到Azure Web App后调用完全正常。

错误信息 #

Error: System.Net.Http.HttpRequestException: The SSL connection could not be established, see inner exception.
System.Security.Authentication.AuthenticationException: Authentication failed because the remote party sent a TLS alert: '112'.

已尝试通过ServicePointManager设置安全协议为TLS 1.2，但无效果；使用Wireshark抓包确认本地机器确实以TLS 1.2发起请求。

TLS alert代码112对应unrecognized_name，说明第三方API服务器无法识别客户端发送的SNI（Server Name Indication）字段，或是本地环境的TLS握手参数与Azure环境存在差异。以下是具体排查和解决步骤：

1. 对齐本地与Azure的.NET运行时版本 #

Azure Web App使用的.NET版本可能与本地开发环境不一致，不同版本的.NET HttpClient对SNI的处理逻辑有差异：

• 登录Azure门户，查看目标Web App的「配置」→「常规设置」中的.NET版本
• 将本地项目的目标框架版本调整为与Azure一致，重新编译测试

2. 显式配置HttpClient的SNI参数 #

在注册IHttpClientFactory时，强制指定SNI的服务器名称，避免本地环境自动生成的SNI不符合第三方API要求：

services.AddHttpClient("ThirdPartyApiClient")
    .ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler
    {
        SslProtocols = SslProtocols.Tls12,
        // 显式指定第三方API的域名，确保SNI字段正确
        ServerName = "your-third-party-api-domain.com"
    });

注意：测试时可临时添加ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator跳过证书验证，确认是否为SNI问题，但生产环境必须移除该配置。

3. 排查本地代理/防火墙干扰 #

Windows 11上的杀毒软件、VPN、代理工具可能修改或拦截TLS握手包，导致SNI字段异常：

• 临时关闭所有第三方安全软件、VPN和代理服务
• 重新运行应用测试API调用

4. 更新本地Windows根证书 #

本地系统缺少第三方API的根证书或证书信任链不完整，会导致SSL验证失败：

• 打开「控制面板」→「Internet选项」→「内容」→「证书」
• 切换到「受信任的根证书颁发机构」标签，点击「导入」手动添加第三方API的根证书；或通过Windows更新安装最新的根证书包

5. 验证本地TLS 1.2配置 #

确认本地系统的TLS 1.2协议是否正确启用：

1. 打开注册表编辑器（regedit）
2. 定位到路径：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client
3. 确保Enabled值为1，DisabledByDefault值为0（若不存在则新建DWORD值）
4. 重启电脑后重新测试

6. 用curl对比本地与Azure的请求差异 #

• 本地命令行执行：curl -v https://your-third-party-api-domain.com，查看TLS握手日志中的SNI信息
• 登录Azure Web App的Kudu控制台（https://<your-app-name>.scm.azurewebsites.net），执行相同的curl命令
• 对比两者的TLS握手参数（如SNI、ALPN扩展、证书链），定位差异点

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