跨编译AWS CDK栈中执行AWS SAM build命令失败求助

问题原因 #

CDK能正常构建ARM64镜像是因为它会根据你指定的Platform: awsecrassets.Platform_LINUX_ARM64()，自动向Docker传递完整的BUILDPLATFORM、TARGETPLATFORM和TARGETARCH参数，确保跨平台构建流程正常。

而SAM默认不会从CDK生成的CloudFormation模板中自动继承Lambda的架构配置：

• 未指定架构时，SAM以本地amd64架构为构建目标，不会传递BUILDPLATFORM变量，导致Dockerfile中--platform=$BUILDPLATFORM的变量为空，触发平台解析错误。
• 硬写静态平台时，SAM构建出的镜像实际架构为amd64，与Lambda要求的arm64不匹配，出现镜像平台校验失败的错误。

解决方案 #

1. 构建时显式指定ARM64架构 #

运行sam build时添加--architecture arm64参数，让SAM明确构建目标架构，自动传递对应的平台变量给Docker：

sam build --use-container --architecture arm64 -t ./cdk.out/AppNameStack.template.json

2. 给Dockerfile添加参数默认值 #

为避免BUILDPLATFORM变量为空导致的解析错误，在Dockerfile中给它设置默认值：

FROM --platform=${BUILDPLATFORM:-linux/amd64} golang:1.22.4-alpine3.20 AS builder
WORKDIR /

ENV CGO_ENABLED="0"

ARG TARGETOS
ARG TARGETARCH
ENV GOOS=$TARGETOS
ENV GOARCH=$TARGETARCH

# ... 构建步骤 ...

FROM scratch
WORKDIR /
EXPOSE 5000
COPY --from=builder /app /

CMD ["/app"]

3. 配置samconfig.toml持久化架构设置（可选） #

如果不想每次构建都加参数，可以在项目根目录的samconfig.toml中添加默认架构配置：

[build]
architecture = "arm64"

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