Visual Studio 2019运行Docker化ASP.NET 5应用HTTPS证书错误问题

你本地的开发证书本身是正常的（IIS/Kestrel能启动、新建项目Docker能跑已经验证），问题出在现有项目的配置覆盖了Visual Studio Docker启动的默认HTTPS证书注入逻辑，常见原因如下：

• launchSettings.json的Docker启动配置缺失useSSL=true、sslPort字段，导致VS不会自动映射本地证书到容器、也不会注入证书相关环境变量
• 项目代码中硬编码了Kestrel的HTTPS证书路径/密码，仅适配本地环境，容器内找不到对应证书文件
• 项目用户机密（secrets.json）中配置了自定义的Kestrel证书参数，覆盖了VS给容器注入的默认配置
• 项目添加Docker支持时选择的容器类型（Windows/Linux）和本地Docker Desktop运行的容器模式不匹配，导致证书映射路径错误

1. 核对launchSettings.json配置 #

对比可正常运行的新建项目的Docker启动配置，补全缺失字段：

"Docker": {
  "commandName": "Docker",
  "launchBrowser": true,
  "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
  "publishAllPorts": true,
  "useSSL": true,
  "sslPort": 44301 // 可替换为其他未被占用的HTTPS端口
}

2. 检查Kestrel硬编码配置 #

查看Program.cs/Startup.cs中是否有硬编码的Kestrel HTTPS证书配置，示例如下：

webBuilder.UseKestrel(options =>
{
    options.ListenAnyIP(5001, o => o.UseHttps("本地证书路径.pfx", "硬编码密码"));
});

如果存在此类配置，直接删除即可，Kestrel会自动读取VS注入的容器内证书路径、密码环境变量；如果需要保留自定义配置，可修改为适配容器内的默认证书路径：

• Linux容器默认路径：/root/.dotnet/https/[你的项目名称].pfx
• Windows容器默认路径：C:\Users\ContainerUser\AppData\Roaming\ASP.NET\Https\[你的项目名称].pfx

3. 清理用户机密中的自定义证书配置 #

右键项目 -> 选择「管理用户机密」打开secrets.json，删除所有Kestrel:Certificates开头的配置项，避免覆盖VS的默认注入参数。

4. 清理缓存重试 #

• 停止并删除该项目对应的所有Docker容器、镜像
• 关闭Visual Studio，删除项目根目录下的.vs、bin、obj文件夹
• 重新打开项目，选择Docker配置启动即可。

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