ASP.NET Core7 Docker容器启动报exec格式错误的原因排查

错误根源 #

exec /usr/bin/dotnet: exec format error 完全是镜像架构与树莓派4的ARM64架构不匹配导致的——你实际构建的是linux/amd64架构的镜像，而树莓派4是ARM64（aarch64）架构，无法运行x86/amd64的二进制文件。

为什么设置了linux-arm64还是生成amd64镜像？ #

你提到的“设置runtime为linux-arm64”应该是指dotnet publish的-r参数，但这只是让.NET编译出适配ARM64的依赖，Docker构建过程没有指定目标架构才是核心问题：

• 如果你在x86/amd64架构的主机（比如普通PC）上用常规docker build命令构建，Docker会默认拉取与当前主机匹配的基础镜像（mcr.microsoft.com/dotnet/aspnet:7.0的amd64版本），最终生成的镜像自然是linux/amd64架构。
• 项目文件里的<PlatformTarget>ARM64</PlatformTarget>仅影响.NET编译阶段的目标平台，无法改变Docker镜像的底层架构。

解决步骤 #

1. 使用Docker Buildx进行跨平台构建
   Docker Buildx是官方的跨平台构建工具，能在x86主机上直接生成ARM64架构的镜像。执行以下命令构建并推送到DockerHub：

   docker buildx build --platform linux/arm64 -t [你的DockerHub用户名]/[镜像名]:[标签] --push .
   

   注意：如果是首次使用Buildx，可能需要先创建构建器实例：docker buildx create --use

2. 显式指定ARM64基础镜像（辅助验证）
   在Dockerfile中直接指定ARM64版本的基础镜像，避免拉取错误架构的镜像，同时在发布阶段明确指定目标runtime：

   # 替换基础镜像为ARM64版本
   FROM mcr.microsoft.com/dotnet/aspnet:7.0-arm64v8 AS base
   WORKDIR /app
   EXPOSE 80
   EXPOSE 443
   
   FROM mcr.microsoft.com/dotnet/sdk:7.0-arm64v8 AS build
   WORKDIR /src
   COPY ["WebApplication3.csproj", "."]
   RUN dotnet restore "./WebApplication3.csproj"
   COPY . .
   WORKDIR "/src/."
   RUN dotnet build "WebApplication3.csproj" -c Release -o /app/build
   
   FROM build AS publish
   RUN dotnet publish "WebApplication3.csproj" -c Release -o /app/publish /p:UseAppHost=false -r linux-arm64
   
   FROM base AS final
   WORKDIR /app
   COPY --from=publish /app/publish .
   ENTRYPOINT ["dotnet", "WebApplication3.dll"]
   

3. 验证镜像架构
   推送到DockerHub后，可以用以下命令检查镜像架构：

   docker buildx imagetools inspect [你的DockerHub用户名]/[镜像名]:[标签]
   

   输出中应该能看到Platform: linux/arm64。

验证解决方案 #

在树莓派4上拉取新构建的镜像并启动，应该不会再出现exec format error错误。

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