部署Node.js镜像至AWS ECS遇exec format error问题求助

核心原因 #

你本地使用的是Apple Silicon（ARM64架构）设备，默认构建的Docker镜像是ARM64格式，但AWS ECS的任务定义运行在Linux/x86_64环境，架构不兼容导致二进制文件（如pm2-runtime、node）无法执行，触发exec format error。

解决方案 #

• 强制构建x86_64架构的镜像
  使用Docker的多架构构建功能，指定目标平台为linux/amd64，确保镜像能在ECS的x86环境运行：

  # 构建并直接推送到ECR（推荐）
  docker buildx build --platform linux/amd64 -t <你的ECR仓库地址>:<标签> . --push
  

  如果需要先本地构建验证，可添加--load参数：

  docker buildx build --platform linux/amd64 -t api-dev:amd64 . --load
  

  然后本地运行验证：

  docker run -it -p 3000:3000 api-dev:amd64
  

• 验证镜像架构
  构建完成后，检查镜像的架构信息，确认是amd64：

  docker inspect <镜像ID或名称> | grep -A 2 "Architecture"
  

  输出示例：

  "Architecture": "amd64",
  "Os": "linux",
  

  推送到ECR后，也可以在AWS控制台的ECR镜像详情页查看平台信息，确认显示为linux/amd64。

• 额外注意事项

  • 基础镜像node:lts-alpine本身支持多架构，无需更换，只需在构建时指定目标平台即可。
  • 避免直接在ARM设备上默认构建镜像后推送到ECR，必须显式指定x86_64平台。

内容的提问来源于stack exchange，提问作者Michal Ružička Ružička