执行sam build --use-container时遇镜像不存在错误求助

问题原因 #

M2 Pro为arm64架构，SAM CLI 1.154.0默认尝试拉取x86_64版本的Python 3.12构建镜像，但该镜像不存在，导致容器创建失败。

修复方案 #

• 指定arm64架构镜像构建
  执行构建命令时直接指定对应架构的镜像：

  sam build --use-container --build-image public.ecr.aws/sam/build-python3.12:latest-arm64
  

• 配置默认架构镜像
  在项目根目录的samconfig.toml中添加以下配置，后续构建无需重复指定：

  [default.build.parameters]
  build_image = "public.ecr.aws/sam/build-python3.12:latest-arm64"
  

• 升级SAM CLI版本
  旧版本SAM CLI在arm64设备上的架构自动匹配存在问题，升级到最新版本可解决：

  brew upgrade aws-sam-cli
  

• 临时启用x86_64兼容模式（不推荐）
  若必须使用x86_64镜像，可通过Docker平台参数强制兼容（性能会受影响）：

  sam build --use-container --platform linux/amd64
  

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