ECS EC2启动类型运行Spring Boot容器时出现Exec格式错误

问题场景 #

我通过CDK搭建ECS服务栈，指定使用t4g.micro（ARM架构）实例与Amazon Linux 2 ARM AMI，部署由Spring Boot Gradle插件构建的容器：

CDK启动模板代码 #

var launchTemplate = LaunchTemplate.Builder.create(this, "LaunchTemplate")
    .instanceType(new InstanceType(this.instanceType))
    .securityGroup(sg)
    .userData(UserData.forLinux())
    .blockDevices(List.of(BlockDevice.builder()
        .deviceName("/dev/xvda")
        .volume(ebs).build()))
    .machineImage(EcsOptimizedImage.amazonLinux2((AmiHardwareType.ARM)))
    .instanceProfile(instanceProfile)
    .build();

镜像构建命令 #

./gradlew bootBuildImage --imagePlatform linux/arm64 --publishImage --imageName "$ecrRepo:$version"

尽管已指定ARM平台与AMI，容器启动仍报错：

[31;1mERROR: [0mfailed to launch: exec.d: failed to execute exec.d file at path '/layers/paketo-buildpacks_ca-certificates/helper/exec.d/ca-certificates-helper': fork/exec /layers/paketo-buildpacks_ca-certificates/helper/exec.d/ca-certificates-helper: exec format error

解决方案 #

• 确保构建环境支持跨架构镜像构建
  如果在x86_64机器上构建ARM64镜像，必须先安装QEMU模拟组件，否则Paketo构建包可能会混入x86_64架构的二进制文件：

  docker run --privileged --rm tonistiigi/binfmt --install all
  

  执行后再重新构建镜像。

• 验证镜像实际架构
  检查推送至ECR的镜像是否确实为ARM64架构：

  aws ecr describe-images --repository-name <你的ECR仓库名> --image-ids imageTag=<版本号> | grep Architecture
  

  若输出不是arm64，说明构建命令的--imagePlatform参数未生效，需检查Docker buildx是否启用或构建环境配置。

• 在ECS任务定义中指定ARM64架构
  即使ECS实例是ARM架构，若任务定义未明确指定CPU架构，可能会默认以兼容模式运行，导致执行错误。在CDK中添加以下配置：

  TaskDefinition taskDef = TaskDefinition.Builder.create(this, "TaskDef")
      .compatibility(Compatibility.EC2)
      .cpu("256")
      .memoryMiB("512")
      .cpuArchitecture(CpuArchitecture.ARM64) // 必须指定
      .build();
  

• 升级Spring Boot版本
  部分旧版本的Spring Boot对应的Paketo构建包存在跨架构构建的bug，升级到较新版本（如2.7.x及以上）可解决此类兼容性问题。

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