Docker启动.NET Core容器后立即停止的问题排查求助

一、最可能的直接原因：Docker Run命令参数顺序错误 #

Docker Run的语法要求选项参数（如-p、--name）必须放在镜像名称之前，你当前的命令把-p 81:80放在了镜像名之后，导致这个参数被当成了容器内应用的启动参数，而非Docker的端口映射配置：

# 错误命令
docker run --name ticket-management-api tickets/ticket-management-api -p 81:80

# 正确命令
docker run --name ticket-management-api -p 81:80 tickets/ticket-management-api

修正后重新启动容器，端口映射应该能正常生效，同时观察容器是否还会退出。

二、进一步排查步骤 #

如果修正命令后容器依然退出，按以下步骤排查：

1. 查看容器完整退出日志 #

默认日志可能只显示了EF初始化的部分，用以下命令查看完整日志，定位启动失败的具体原因：

docker logs ticket-management-api

重点关注EF初始化后的报错信息，比如数据库连接失败、配置文件缺失、依赖项加载失败等。

2. 验证容器内的应用配置与依赖 #

进入容器内部检查应用文件和配置是否正常：

# 启动临时容器进入交互模式
docker run -it --rm tickets/ticket-management-api bash

在容器内执行以下操作：

• 查看/app目录下是否存在Security.Api.dll及完整的依赖文件
• 手动执行启动命令dotnet Security.Api.dll，直接观察启动时的报错信息
• 检查appsettings.json或环境变量中的数据库连接字符串是否正确（容器内可能无法访问本地数据库，需确认网络连通性）

3. 检查容器退出状态码 #

通过退出状态码快速判断问题类型：

docker inspect ticket-management-api | grep ExitCode

常见状态码说明：

• 1：应用自身启动失败（如代码错误、配置错误）
• 137：容器因内存不足被强制终止
• 0：应用正常退出（可能是启动后立即执行完任务而非持续运行）

4. 核对.NET版本兼容性 #

确认本地开发环境的.NET 6版本与镜像中的mcr.microsoft.com/dotnet/aspnet:6.0版本一致，避免因版本差异导致的运行时错误。

内容的提问来源于stack exchange，提问作者Kevin Pontón