ASP.NET Core 8.0构建报错MSB4018：Message任务意外失败

问题背景 #

通过GitHub Action构建arm64架构的ASP.NET Core 8.0模板项目时，执行dotnet restore命令触发MSB4018错误，错误指向NuGet.targets中的Message任务空引用，导致构建终止。本地x64架构构建可正常运行，项目无额外NuGet包及自定义代码。

错误原因 #

这是.NET SDK 8.0.401在QEMU模拟arm64环境下的已知兼容性问题：SDK内置的MSBuild Message任务在解析$(MSBuildProjectFullPath)变量时出现空引用，导致任务初始化失败。

解决方案 #

方案1：升级.NET SDK镜像版本 #

微软在8.0.402及以上版本的SDK镜像中修复了该QEMU模拟arm64的兼容性问题，修改Dockerfile中的SDK基础镜像：

# 替换原SDK镜像
# FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
FROM mcr.microsoft.com/dotnet/sdk:8.0.402 AS build
# 或使用基于Debian 12的稳定镜像
# FROM mcr.microsoft.com/dotnet/sdk:8.0-bookworm AS build

方案2：合并restore与build步骤 #

跳过单独的dotnet restore命令，直接在dotnet build时添加--restore参数，让build自动处理依赖还原，避免单独触发restore时的bug：

# 移除原单独的restore步骤
# COPY PinfoBackend.csproj ./
# RUN dotnet restore "PinfoBackend.csproj" --disable-parallel

# 合并为以下步骤
COPY PinfoBackend.csproj ./
COPY . ./
RUN dotnet build "PinfoBackend.csproj" -c $BUILD_CONFIGURATION --restore --disable-parallel

方案3：临时规避QEMU用户命名空间问题 #

在GitHub Action的setup-qemu步骤中添加参数禁用用户命名空间克隆，部分场景下可规避该问题：

- name: Set up QEMU
  uses: docker/setup-qemu-action@v2
  with:
    platforms: linux/amd64,linux/arm64
    image: tonistiigi/binfmt:qemu-v7.0.0
    options: --disable-userspace

验证 #

修改后重新触发GitHub Action构建，arm64架构的镜像应可正常完成restore和build流程。

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