AWS ECS服务无法启动Node.js Express容器任务的问题排查

1. 核心错误原因：Docker镜像架构不兼容 #

exec /usr/local/bin/docker-entrypoint.sh: exec format error 是导致任务启动失败的关键原因，本质是镜像架构与Fargate运行环境不匹配：

• 若你使用Apple Silicon（M1/M2等）系列Mac本地构建镜像，默认会生成arm64架构的镜像
• AWS Fargate默认运行环境为x86_64架构（除非手动指定arm64平台），架构不兼容会直接导致容器无法启动，进而引发ALB 503错误（无可用后端任务提供服务）

2. 镜像架构问题解决方法 #

方法一：构建多架构兼容镜像（推荐） #

使用Docker Buildx构建同时支持x86_64和arm64的镜像，适配所有Fargate运行环境：

# 初始化Buildx环境（首次执行）
docker buildx create --use

# 构建并推送多架构镜像到ECR
docker buildx build --platform linux/amd64,linux/arm64 -t <你的ECR仓库URI>:latest --push .

方法二：指定x86_64架构构建镜像 #

若无需arm64兼容，直接指定x86_64架构构建：

docker build --platform linux/amd64 -t <你的ECR仓库URI>:latest .

# 推送镜像到ECR
docker push <你的ECR仓库URI>:latest

3. 重新部署验证 #

• 创建新的任务定义版本，引用修复后的镜像；或删除现有ECS服务，重新创建服务并关联新镜像
• 等待任务启动后，检查CloudWatch日志确认无启动报错，同时查看ALB目标组状态，确认后端任务处于健康状态

4. 额外配置检查（避免后续问题） #

• 安全组规则：
  • ecs-task-sg：允许来自ecs-alb-sg的3000端口访问（匹配应用监听端口）
  • ecs-alb-sg：允许外部（0.0.0.0/0）的80/443端口访问
• 负载均衡器目标组：
  • 确认健康检查路径设置为/health（你的应用已提供该端点），端口指定为3000
  • 确保目标组协议为HTTP，与应用监听协议一致
• 任务定义配置：
  • 容器端口映射正确：容器端口设为3000，主机端口留空（Fargate无需配置主机端口）
  • 任务执行角色/任务角色具备拉取ECR镜像、写入CloudWatch日志的必要权限

内容的提问来源于stack exchange，提问作者Wai Yan Hein