如何解决x86目标ASP.NET Web API SDK6.0 Docker镜像构建报错问题

问题根源 #

默认的.NET 6官方Docker镜像（mcr.microsoft.com/dotnet/sdk:6.0、mcr.microsoft.com/dotnet/aspnet:6.0）基于x64架构构建，而你的应用目标平台为x86，架构不匹配导致运行时抛出System.BadImageFormatException。

解决方案 #

修改Dockerfile，确保构建和运行阶段都使用x86架构镜像，并在构建发布时明确指定目标平台：

修改后的完整Dockerfile #

# 使用x86版本的ASP.NET基础镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0-x86 AS base
WORKDIR /app
EXPOSE 80

# 使用x86版本的SDK镜像进行构建
FROM mcr.microsoft.com/dotnet/sdk:6.0-x86 AS build
WORKDIR /src
COPY ["WebApplication4.csproj", "."]
# 恢复依赖时指定x86平台
RUN dotnet restore "./WebApplication4.csproj" -r win-x86
COPY . .
WORKDIR "/src/."
# 构建时指定目标平台和运行时
RUN dotnet build "WebApplication4.csproj" -c Release -o /app/build -r win-x86 --self-contained false

FROM build AS publish
# 发布时同样指定目标平台和运行时
RUN dotnet publish "WebApplication4.csproj" -c Release -o /app/publish -r win-x86 --self-contained false

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

关键修改点说明 #

• 镜像架构匹配：给base和build阶段的镜像添加-x86后缀，使用官方提供的x86专属镜像。
• 指定运行时：在dotnet restore、build、publish命令中添加-r win-x86参数（若Docker环境为Linux，替换为linux-x86），明确告知.NET SDK按x86平台处理依赖与编译。
• 非独立发布：添加--self-contained false，复用基础镜像中的.NET运行时，减少镜像体积。

额外验证 #

检查项目文件（.csproj）中的目标平台配置是否正确：

<PropertyGroup>
  <TargetFramework>net6.0</TargetFramework>
  <PlatformTarget>x86</PlatformTarget>
</PropertyGroup>

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