M系列Mac部署.NET 8 AOT Lambda至AWS遇架构不匹配错误求助

核心问题 #

.NET AOT编译要求构建环境与目标运行环境架构完全匹配。AWS Lambda CLI文档提及会自动通过Docker处理跨架构构建，但在M系列Mac（Arm64）上可能因CLI版本或配置问题，未自动触发Docker构建流程，导致直接用主机Arm64环境编译X64 Lambda时抛出架构不匹配错误。

解决步骤 #

1. 升级Lambda CLI工具 #

旧版本工具可能存在Arm64适配缺陷，先更新到最新版：

dotnet tool update -g Amazon.Lambda.Tools

2. 强制CLI使用Docker构建 #

部署时显式指定Docker构建和目标架构，避免CLI默认用主机架构编译：

dotnet lambda deploy-function <你的函数名> --docker-build --architecture x86_64

也可以在项目根目录的aws-lambda-tools-defaults.json中添加配置，省去每次命令输入参数：

{
  "profile": "<你的AWS配置文件>",
  "region": "<目标区域>",
  "function-name": "<你的函数名>",
  "docker-build": true,
  "architecture": "x86_64"
}

3. 修正自定义Dockerfile配置 #

如果自行编写Dockerfile，必须确保全程使用X64架构的镜像和编译参数：

# 使用X64的.NET 8 SDK镜像作为构建阶段
FROM mcr.microsoft.com/dotnet/sdk:8.0-jammy-amd64 AS build
WORKDIR /src
COPY ["你的Lambda项目.csproj", "."]
RUN dotnet restore "./你的Lambda项目.csproj"
COPY . .
WORKDIR "/src/."
# 明确指定目标架构为linux-x64并启用AOT
RUN dotnet publish "你的Lambda项目.csproj" -c Release -o /app/publish \
    --runtime linux-x64 \
    --self-contained true \
    /p:PublishAot=true \
    /p:TargetArchitecture=x64

# 使用X64的Lambda运行时镜像
FROM public.ecr.aws/lambda/dotnet:8-amd64
WORKDIR /var/task
COPY --from=build /app/publish .

部署时指定该Dockerfile：

dotnet lambda deploy-function <你的函数名> --dockerfile Dockerfile --architecture x86_64

4. 开启Docker的X64模拟支持 #

确保Docker Desktop已启用Rosetta 2模拟：打开Docker Desktop设置 → Features in development → 勾选"Use Rosetta for x86/amd64 emulation on Apple Silicon"。

关键澄清 #

• 完全可以通过Docker从Arm64 Mac部署X64架构的Lambda，之前的错误是因为CLI未正确触发Docker构建，或Dockerfile架构配置错误。
• 跨架构部署时必须显式指定架构参数，不要依赖CLI的自动检测，避免默认使用主机Arm64环境编译。

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