M1 Mac构建.NET 8应用linux/amd64 Docker镜像运行报错排查

问题根源 #

虽然docker buildx build指定了镜像平台为linux/amd64，但dotnet publish阶段默认使用构建环境的架构（M1 Max的arm64）编译程序集，导致最终镜像内的MyProject.dll是arm64架构，与x86_64服务器不兼容，触发exec format error。

修复方案 #

1. 修改Dockerfile，强制指定目标架构 #

在dotnet publish命令中添加--runtime linux-x64参数，确保编译出x64架构的程序集：

FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["src/MyProject/MyProject.csproj", "src/MyProject/"]
RUN dotnet restore "src/MyProject/MyProject.csproj"
COPY . .
WORKDIR "/src/src/MyProject"
RUN dotnet build "MyProject.csproj" -c Release -o /app/build

FROM build AS publish
# 指定目标runtime为linux-x64，复用基础镜像的runtime而非自包含打包
RUN dotnet publish "MyProject.csproj" -c Release -o /app/publish --runtime linux-x64 --no-self-contained

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENV ASPNETCORE_FORWARDEDHEADERS_ENABLED=true
ENTRYPOINT ["dotnet", "MyProject.dll"]

2. 确保buildx构建器支持跨平台 #

若尚未配置多平台构建器，执行以下命令创建并启用：

docker buildx create --use --name multi-platform-builder

3. 重新构建镜像 #

执行原构建命令重新生成镜像：

docker buildx build --platform linux/amd64 -t myproject:latest --load -f src/MyProject/Dockerfile .

验证修复效果 #

运行临时容器检查程序集架构：

docker run --rm --platform linux/amd64 myproject:latest dotnet --info

输出中出现RID: linux-x64标识，说明程序集已为x64架构，此时部署到x86_64服务器即可正常运行。

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