Docker中运行.NET项目遇HTTPS端点配置异常求助

问题重现 #

通过Visual Studio使用docker-compose运行.NET项目时，数据库镜像创建成功，但应用容器启动后直接退出，Docker日志抛出以下异常：

Unhandled exception. System.InvalidOperationException: Unable to configure HTTPS endpoint. No server certificate was specified, and the default developer certificate could not be found or is out of date.

已尝试dotnet dev-certs https --clean/--trust、清除Chrome HSTS记录、重启Docker/VS、重装组件等操作，均无效。

解决步骤 #

1. 确认Docker-Compose的证书挂载配置

.NET开发证书默认存储在Windows用户目录下，容器需要通过挂载访问这些证书。检查docker-compose.yml中对应服务的配置：

services:
  your-app-service:
    volumes:
      # 挂载用户密钥（可选，若用到UserSecrets）
      - ${APPDATA}/Microsoft/UserSecrets:/root/.microsoft/usersecrets:ro
      # 挂载HTTPS证书目录
      - ${USERPROFILE}/.aspnet/https:/root/.aspnet/https:ro

同时确保添加了证书相关的环境变量：

environment:
  - ASPNETCORE_ENVIRONMENT=Development
  - ASPNETCORE_URLS=https://+:443;http://+:80
  # 指定容器内证书路径和密码
  - ASPNETCORE_Kestrel__Certificates__Default__Path=/root/.aspnet/https/YourProjectName.pfx
  - ASPNETCORE_Kestrel__Certificates__Default__Password=YourCertificatePassword

2. 手动生成容器专用证书

如果默认证书无法被容器识别，手动生成指定路径的证书：

# 生成PFX格式证书到用户目录的HTTPS文件夹
dotnet dev-certs https -ep ${USERPROFILE}/.aspnet/https/YourProjectName.pfx -p YourStrongPassword123!
# 信任该证书
dotnet dev-certs https --trust

生成后确保docker-compose.yml中的环境变量路径和密码与生成的证书一致。

3. 临时禁用HTTPS调试（生产环境禁用）

若仅需快速调试，可暂时关闭HTTPS：

• 修改项目Properties/launchSettings.json，将applicationUrl改为http://+:80；
• 更新docker-compose.yml中的环境变量：

  environment:
    - ASPNETCORE_ENVIRONMENT=Development
    - ASPNETCORE_URLS=http://+:80
  

  同时移除证书相关的挂载和环境变量。

4. WSL2后端的额外检查

如果使用Docker Desktop的WSL2后端：

• 打开Docker Desktop设置，确认WSL集成已启用，且目标WSL发行版（如Ubuntu）已勾选；
• 进入WSL终端，将Windows下的证书复制到WSL的对应目录：

  cp /mnt/c/Users/YourWindowsUsername/.aspnet/https/* ~/.aspnet/https/
  

  替换YourWindowsUsername为你的Windows用户名。

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