macOS下Docker运行.NET 5.0 WebApi时HTTPS端点无法配置报错如何解决？

1 优先验证挂载资源有效性 #

本地Visual Studio可正常运行HTTPS，说明宿主机基础证书配置正常，先排查容器挂载环节问题：

• 执行命令ls ${HOME}/.aspnet/https/，确认目录下存在和程序集同名的pfx证书：你项目启动的是MyApi.dll，对应证书必须命名为MyApi.pfx，命名不匹配会直接导致Kestrel找不到证书
• 执行命令ls ${HOME}/.microsoft/usersecrets/，进入对应项目的机密目录，确认存在配置项Kestrel:Certificates:Development:Password，该值必须和证书导出时设置的密码一致

2 完整修复操作流程 #

按顺序执行以下命令即可解决问题：

2.1 重新生成规范的开发证书 #

# 清理所有旧的.NET开发证书
dotnet dev-certs https --clean
# 生成和项目程序集同名的pfx证书，密码可自定义，示例用pass123
dotnet dev-certs https -ep ${HOME}/.aspnet/https/MyApi.pfx -p pass123
# 信任新生成的证书
dotnet dev-certs https --trust

2.2 配置项目用户机密 #

进入MyApi.csproj所在的项目根目录，执行：

# 初始化用户机密（如果还没初始化过）
dotnet user-secrets init
# 配置证书密码，和上一步设置的密码保持一致
dotnet user-secrets set "Kestrel:Certificates:Development:Password" "pass123"

2.3 重新发布项目、构建镜像 #

你Dockerfile使用的是Release目录的发布文件，必须重新发布确保二进制文件最新：

dotnet publish -c Release
docker build -t my-app-api .

2.4 启动容器（两种方案二选一） #

如果用户机密挂载正常，用原启动命令即可；如果仍报错，可直接在启动参数里传入密码，省略用户机密挂载：

docker run -it -p 40080:80 -p 40443:443 \
-e ASPNETCORE_URLS="https://+;http://+" \
-e ASPNETCORE_HTTPS_PORT=40443 \
-e ASPNETCORE_ENVIRONMENT=Development \
-e Kestrel__Certificates__Development__Password="pass123" \
-v ${HOME}/.aspnet/https/:/root/.aspnet/https/ \
my-app-api

3 特殊场景排查 #

如果执行完以上步骤仍报错，检查Docker Desktop的文件共享配置：打开Docker Desktop设置->资源->文件共享，确认${HOME}目录已经被添加到允许共享的列表中，否则挂载的证书和机密目录会是空目录，导致容器无法读取证书。

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