Visual Studio 2019添加Docker Compose编排后ASP.NET Core Web应用无法启动

问题核心原因 #

你遇到的两个故障分别对应两个不同的配置问题：

1. 最初的Kestrel启动失败报错，是因为Linux容器内没有可用的HTTPS开发证书，VS本地调试ASP.NET Core时依赖主机上的开发证书，但默认生成的编排配置如果缺失证书挂载规则，容器就无法读取主机上的合法证书。
2. 你修改Dockerfile新增RUN dotnet dev-certs https后无端口暴露、无日志输出，是因为这条指令仅在镜像构建阶段生成了未被信任的临时证书，且VS默认启用的容器快速调试模式会跳过Dockerfile final阶段的自定义修改，最终服务没有正常启动。

具体解决步骤 #

步骤1：恢复主机开发证书状态 #

先删除你之前在Dockerfile中新增的RUN dotnet dev-certs https指令，恢复默认Dockerfile配置。
打开本地终端（PowerShell/CMD均可），依次执行以下命令重置本地ASP.NET Core开发证书：

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

执行第二条命令时弹出的系统确认框全部选择「是」，完成本地证书的信任配置。

步骤2：调整VS证书配置 #

打开VS顶部菜单「工具」→「选项」，找到「ASP.NET Core」分类，将「信任ASP.NET Core SSL证书」选项修改为「自动」，保存设置后重启VS。

步骤3：确认Docker Compose挂载配置 #

打开解决方案中docker-compose.override.yml文件，确认你的Web服务配置中包含证书和用户机密的挂载规则，参考配置如下：

services:
  # 此处名称替换为你实际的服务名称
  webapplication7:
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_URLS=https://+:443;http://+:80
    ports:
      - "8000:80"
      - "44300:443"
    volumes:
      # 挂载本地用户机密到容器
      - ${APPDATA}/Microsoft/UserSecrets:/root/.microsoft/usersecrets:ro
      # 挂载本地HTTPS开发证书到容器，解决证书缺失问题，核心配置
      - ${APPDATA}/ASP.NET/Https:/root/.aspnet/https:ro

步骤4：清理缓存重新启动 #

1. 打开Docker Desktop，删除所有和当前项目相关的容器、镜像以及compose堆栈
2. 右键VS中的docker-compose项目，选择「清理」，再选择「重新生成」
3. 按下F5启动调试即可正常运行。

为什么无法开箱即用 #

该功能默认是可以正常运行的，你遇到的问题大概率是之前本地ASP.NET Core开发证书状态异常，且VS的证书提示设置为「提示我」时，系统弹窗被安全软件拦截，没有完成证书信任流程，导致默认生成的编排配置无法读取到合法证书。

内容的提问来源于stack exchange，提问作者Sean W.