ASP.NET 6镜像docker run运行卡顿无法访问API该如何排查？

问题排查步骤 #

1. 优先修正docker run命令的已知错误 #

你当前使用的运行命令存在3个明显问题，是导致访问失败的最直接原因：

• 参数顺序错误：Docker要求镜像名称必须放在所有运行参数的末尾，你当前将镜像名放在最前面，后续的--restart、-d、-p等参数都会被识别为传入容器内应用的启动参数，完全不会被Docker本身生效
• 端口映射规则写反：-p参数格式为宿主机端口:容器内部端口，从启动日志可以看到容器内的ASP.NET服务监听的是80端口，你要映射到宿主机5111端口的话，需要写成-p 5111:80
• 参数拼写错误：--restart的参数值为always，你写的aways为错误拼写

修正后的运行命令如下：

docker run --restart=always -d -p 5111:80 my-image-name

执行完修正后的命令后，先尝试访问http://localhost:5111/swagger，如果仍然无法访问再执行后续排查。

2. 排查Swagger默认配置问题 #

默认ASP.NET 6的项目模板中，Swagger仅在Development环境下会启用，你的启动日志显示当前容器内环境为Production，Swagger默认是关闭状态，也会导致访问失败。
可以临时添加环境变量启动容器，强制启用开发环境验证：

docker run --restart=always -d -p 5111:80 -e ASPNETCORE_ENVIRONMENT=Development my-image-name

如果此时可以正常访问Swagger，说明是环境配置问题。如果需要在生产环境也启用Swagger，需要修改项目的Program.cs代码，将Swagger的注册和中间件配置移到环境判断逻辑之外。

3. 容器运行状态排查 #

如果以上配置修改后仍然无法访问，按以下步骤排查：

• 不要使用docker attach连接容器：ASP.NET默认不会响应标准输入的指令，attach后出现无法用Ctrl+C终止的现象是正常的，改用docker exec -it <容器ID> /bin/bash进入容器内部命令行
• 进入容器后执行curl http://localhost:80/swagger，如果容器内部可以正常返回内容，说明问题出在宿主机的端口映射或者防火墙规则；如果容器内部也无法访问，说明应用本身存在启动异常
• 执行docker logs <容器ID>查看完整容器日志，确认服务启动完成后是否有未捕获的异常输出
• 检查Dockerfile中是否添加了EXPOSE 80的端口声明配置，部分运行环境会依赖该配置做端口识别
• 检查宿主机5111端口是否被其他进程占用：Windows环境执行netstat -ano | findstr :5111，Linux/Mac环境执行lsof -i :5111确认端口无占用

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