.NET Core与Angular项目安装SSL证书后仍遇私密连接错误的排查与解决

可能的原因 #

• 证书未被系统/浏览器信任：localhost的自签名SSL证书默认不会被系统或浏览器认可，就算安装了证书，没把它添加到「受信任的根证书颁发机构」里，浏览器还是会判定连接不安全。
• 证书域名不匹配：生成的SSL证书绑定的域名不是localhost，或者Angular/.NET Core项目配置的访问域名和证书域名不一致。
• 项目SSL配置错误：Angular的angular.json或者.NET Core的launchSettings.json里，要么没开启SSL，要么证书文件路径配置错了，导致实际请求没用到正确的HTTPS证书。
• 浏览器缓存/旧证书残留：浏览器缓存了之前localhost的不安全连接记录，或者旧的未信任证书还在生效，覆盖了新安装的证书。

解决办法 #

1. 把证书添加到信任根证书库 #

• Windows：
  1. 打开「管理用户证书」，找到你的localhost证书，右键→「所有任务」→「导出」，存成.cer格式。
  2. 打开「管理计算机证书」，找到「受信任的根证书颁发机构」→「证书」，右键→「所有任务」→「导入」，把刚才导出的.cer文件导进去。
• macOS：
  打开「钥匙串访问」，找到localhost证书，双击后在「信任」选项卡，把「使用此证书时」改成「始终信任」。

2. 核对证书域名与项目配置 #

• 先在浏览器里查看证书详情，确认证书绑定的域名是localhost。
• Angular项目：修改angular.json的serve配置，确保开启SSL并指向正确的证书路径：

  "serve": {
    "builder": "@angular-devkit/build-angular:dev-server",
    "options": {
      "ssl": true,
      "sslCert": "./ssl/localhost.crt",
      "sslKey": "./ssl/localhost.key"
    }
  }
  

• .NET Core项目：检查launchSettings.json的profiles配置，确保applicationUrl包含HTTPS地址，sslPort正确：

  "profiles": {
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
  

3. 清除浏览器缓存和旧证书 #

• 打开浏览器设置，清除所有缓存（包括Cookie和站点数据），重点清理localhost相关的缓存记录。
• 进入浏览器的证书管理页面，删除所有和localhost有关的旧证书，然后重新访问项目。

4. 重新生成可信的localhost SSL证书 #

• .NET Core直接用命令行重新生成并信任：

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

• Angular可以用mkcert工具生成：
  1. 安装mkcert（根据你的系统选择对应的安装方式）
  2. 生成本地CA并信任：mkcert -install
  3. 生成localhost证书：mkcert localhost
  4. 把生成的localhost.pem和localhost-key.pem文件配置到Angular项目的SSL设置里。

内容的提问来源于stack exchange，提问作者Gagan H M