.NET解决方案运行报错HttpRequestException：SSL连接无法建立求助

可能原因 #

• IIS Express生成的自签名证书未被系统信任：拉取新解决方案后，IIS Express会为API站点生成新的自签名证书，若未手动信任，会导致API无法加载，同时主项目调用API时触发SSL握手失败。
• API地址配置不匹配：解决方案配置文件中记录的API HTTPS端口，与当前IIS Express分配给API站点的端口不一致，请求连接到无效端点引发错误。
• 证书存储存在冲突或过期：之前生成的dotnet开发证书与IIS Express证书冲突，或证书已过期、被吊销，导致SSL验证不通过。
• .NET运行时SSL策略限制：.NET默认的SSL/TLS版本或证书验证逻辑，可能拒绝了未正确信任的IIS Express自签名证书。
• 网络拦截：本地防火墙、杀毒软件或代理工具（如Fiddler）拦截了HTTPS请求，中断SSL连接建立过程。

排查方向 #

• 验证IIS Express证书状态
  1. 打开%USERPROFILE%\Documents\IISExpress\config\applicationhost.config，找到API站点的HTTPS绑定端口。
  2. 用浏览器访问该端口的HTTPS地址（如https://localhost:xxxx），若提示证书错误，进入证书详情页，将证书安装到本地计算机的「受信任的根证书颁发机构」。
• 核对API配置地址
  检查项目的appsettings.json/appsettings.Development.json，确认主项目调用API的URL端口与IIS Express当前运行的API端口完全一致。
• 重置开发证书
  1. 执行命令清理现有证书：dotnet dev-certs https --clean
  2. 重新生成并信任证书：dotnet dev-certs https --trust
  3. 删除「管理计算机证书」中的「IIS Express Development Certificate」，重启Visual Studio让IIS Express重新生成证书。
• 临时跳过证书验证（仅调试用）
  在HttpClient配置中添加以下代码，若请求成功则确认是证书验证问题：

  var handler = new HttpClientHandler();
  handler.ServerCertificateCustomValidationCallback = (_, _, _, _) => true;
  var httpClient = new HttpClient(handler);
  

• 排查网络拦截因素
  暂时关闭本地防火墙、杀毒软件，退出代理工具后重新运行项目，观察问题是否消失。
• 指定SSL/TLS版本
  在项目启动代码中强制指定支持的SSL/TLS版本，避免版本不兼容：

  ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls13;
  

• 获取详细异常信息
  捕获并输出异常的InnerException内容，或在VS调试窗口查看完整堆栈，获取具体错误（如证书链无效、域名不匹配等）。

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