为何仅一个.NET Core Web API项目的HTTPS证书无效？

问题描述 #

一个包含两个.NET Core Web API项目的解决方案，两个项目均配置Swagger，HTTP URL均可正常访问，但HTTPS URL仅能正常访问其中一个项目，另一个项目的证书被浏览器判定为无效。

已执行操作 #

尝试过以下命令清理、生成并信任开发证书，但问题未解决：

dotnet dev-certs https --clean
dotnet dev-certs https
dotnet dev-certs https --trust

执行dotnet dev-certs https -c -t显示证书存在且已受信任，dotnet run无编译错误。

关键观察现象 #

• 两个项目均通过Visual Studio创建，代码内容一致，排除代码层面问题。
• Windows证书管理器中未找到证书，但其中一个项目可正常使用HTTPS。
• 清理证书后，原本正常的项目提示无法生成HTTPS端点（符合预期），但有问题的项目运行无报错，仍无法通过HTTPS访问，疑似未尝试创建HTTPS端点。

解决方案 #

1. 检查launchSettings.json配置差异
   打开两个项目的Properties/launchSettings.json，对比以下配置项：

   • applicationUrl：确认是否包含HTTPS地址（如https://localhost:5001），两个项目的HTTPS端口不能重复。
   • ASPNETCORE_HTTPS_PORT：检查是否正确设置了HTTPS端口。
   • sslPort：Visual Studio调试时使用的SSL端口，需保证唯一且与applicationUrl中的端口一致。
     若有问题的项目缺失HTTPS相关配置，手动添加或复制正常项目的配置项（修改端口避免冲突）。

2. 验证项目HTTPS服务配置
   在项目的Program.cs（.NET 6+）或Startup.cs中，确认存在HTTPS相关配置：

   // .NET 6+ 示例
   var builder = WebApplication.CreateBuilder(args);
   // 确保自动配置HTTPS（默认会加载开发证书）
   builder.WebHost.UseKestrel(options =>
   {
       options.ListenAnyIP(5001, listenOptions =>
       {
           listenOptions.UseHttps();
       });
   });
   
   var app = builder.Build();
   app.UseHttpsRedirection(); // 启用HTTPS重定向
   

   若有问题的项目缺少UseHttpsRedirection或HTTPS监听配置，补充对应代码。

3. 确认开发证书存储位置
   .NET Core开发证书默认存储在当前用户的证书库中，路径为：

   • 打开certmgr.msc，依次展开个人 > 证书，查找颁发者为localhost的证书。
     若找不到，重新执行dotnet dev-certs https --trust，完成后再次检查该位置。

4. 手动指定证书给异常项目
   若默认证书无法被异常项目识别，可在launchSettings.json中手动指定证书指纹：

   "environmentVariables": {
       "ASPNETCORE_Kestrel__Certificates__Default__Path": "path/to/your/certificate.pfx",
       "ASPNETCORE_Kestrel__Certificates__Default__Password": "certificate-password"
   }
   

   或者在Program.cs中配置Kestrel使用指定证书：

   builder.WebHost.UseKestrel(options =>
   {
       options.ListenAnyIP(5001, listenOptions =>
       {
           listenOptions.UseHttps("certificate.pfx", "password");
       });
   });
   

5. 重置项目调试配置
   删除异常项目的Properties/launchSettings.json，右键项目选择「属性」→「调试」，重新生成调试配置，确保HTTPS选项被勾选。

疑问解答 #

为什么一个项目正常另一个异常？ #

核心原因是两个项目的HTTPS配置存在差异：

• 异常项目的launchSettings.json可能缺失HTTPS端点配置，导致未尝试创建HTTPS服务。
• 端口冲突：两个项目使用了相同的HTTPS端口，导致证书绑定失败。
• 证书绑定异常：异常项目未正确加载默认开发证书，可能是配置中指定了不存在的自定义证书。

HTTPS端点在哪里创建？触发条件是什么？ #

• 创建位置：
  1. .NET 6+中，WebApplication.CreateBuilder会自动根据launchSettings.json的配置创建HTTPS端点；也可通过Kestrel配置手动指定HTTPS监听端口（如上述代码示例）。
  2. 旧版本（.NET 5及以下）在Startup.cs的Configure方法中通过UseHttpsRedirection启用HTTPS重定向，ConfigureServices中配置Kestrel的HTTPS选项。
• 触发条件：
  1. 项目配置文件（launchSettings.json或appsettings.json）中包含HTTPS的applicationUrl。
  2. 存在可用的HTTPS证书（默认开发证书或手动指定的证书）。
  3. 项目代码中启用了HTTPS重定向或Kestrel的HTTPS监听。

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