ASP.NET Docker镜像在AWS ECS中部署后立即退出问题求助

优先排查容器日志 #

ECS容器退出的核心原因几乎都能从日志里找到线索，直接通过AWS控制台进入对应任务的日志页面，或者用CLI拉取日志：

aws logs get-log-events --log-group-name /aws/ecs/[你的日志组名称] --log-stream-name [任务对应的日志流名称]

本地运行正常但ECS中出错，大概率是启动阶段的依赖缺失、配置错误或权限问题，日志会给出明确提示。

检查ASP.NET的监听地址配置 #

ASP.NET Core默认仅监听localhost，但容器环境下需要监听0.0.0.0才能对外提供服务，否则应用启动后会因无有效监听端口而退出。可以通过两种方式修正：

• 在Program.cs中显式指定监听地址：

  var builder = WebApplication.CreateBuilder(args);
  builder.WebHost.UseUrls("http://0.0.0.0:80");
  // 其他配置...
  

• 在ECS任务定义中添加环境变量ASPNETCORE_URLS=http://0.0.0.0:80，无需修改代码。

验证任务定义的端口与权限配置 #

• 端口映射：如果使用桥接网络模式，确认任务定义中容器端口（80）与主机端口的映射是否正确；如果是awsvpc模式，检查安全组是否允许80端口的入站/出站流量。
• 端口权限：mcr.microsoft.com/dotnet/aspnet:6.0镜像默认使用非root用户app，Linux系统中低于1024的端口需要root权限，若日志提示端口绑定失败，可改为使用8080端口：
  1. 修改Dockerfile的EXPOSE 8080，保持ENTRYPOINT配置一致
  2. 在任务定义中设置环境变量ASPNETCORE_URLS=http://0.0.0.0:8080

确认镜像一致性 #

检查ECS使用的镜像是否和本地测试的完全一致：

• 本地执行docker inspect [本地镜像名]获取镜像ID
• 在AWS ECR控制台查看对应镜像的ID，确保两者匹配，避免推送旧版本镜像导致的问题

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