.NET 5.0 Web API Docker容器无法访问Swagger且Kestrel启动报错求助

核心报错原因说明 #

你进入容器手动执行dotnet Summit.API.dll报端口占用，是因为容器启动时已经通过Dockerfile里的ENTRYPOINT指令自动运行了该程序，5000端口已经被默认启动的进程占用，重复启动才会触发该错误。
无法访问swagger的问题按以下步骤逐一排查： #

排查步骤 #

1. 修正本地访问地址 #

你执行的容器启动命令为docker container run -itd -p 8000:5000 imageid，该命令是将容器内部的5000端口映射到宿主机的8000端口，因此本地访问地址应为http://localhost:8000/swagger/index.html，而非5000端口。

2. 确认容器运行状态 #

执行以下命令查看容器是否正常运行：
docker ps -a
如果容器状态为Exited，执行以下命令查看启动日志定位错误：
docker logs 你的容器ID

3. 确认Swagger启用逻辑 #

你Dockerfile中已经配置了ASPNETCORE_ENVIRONMENT=Development，默认.NET 5 WebAPI模板会在开发环境自动启用Swagger，如果你修改过启动配置，需检查Startup.cs或Program.cs中是否存在多余的本地环境判断，例如：

// 错误示例：加了IsLocal()判断会导致容器内不加载Swagger
if (env.IsDevelopment() && env.IsLocal())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

删除多余的IsLocal()判断，确保开发环境下无论运行位置都启用Swagger。

4. 确认Kestrel绑定配置 #

你Dockerfile中配置的ASPNETCORE_URLS="http://*:5000"是正确的，会让Kestrel监听所有网卡地址。如果日志中仍有绑定127.0.0.1的报错，检查项目的appsettings.json或启动代码中是否硬编码了Kestrel绑定地址为http://127.0.0.1:5000，删除硬编码配置优先使用环境变量即可。

5. 容器内手动测试方法 #

如果需要在容器内手动启动服务测试，需先终止默认运行的进程：

• 进入容器终端：docker exec -it 你的容器ID bash
• 查找占用5000端口的进程ID：ps aux | grep dotnet
• 终止进程：kill -9 查到的进程ID
• 再执行dotnet Summit.API.dll即可正常启动，不会报端口占用错误。

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