.NET项目Docker构建失败 切换MCR镜像仍报拉取权限错误如何解决

问题根因 #

你最初报错是因为Docker Hub上的microsoft/dotnet镜像仓库已被微软正式弃用下架，所以拉取时返回权限不足错误。
修改Dockerfile后依然报错有两个核心原因：

• Docker BuildKit缓存了旧的Dockerfile构建元数据，没有加载你修改后的新配置
• 你修改后的Dockerfile多阶段构建逻辑存在错误，无法正常完成构建

排查解决步骤 #

• 第一步：清理旧构建缓存并强制加载新Dockerfile构建
  执行以下命令跳过所有缓存，明确指定Dockerfile路径构建：

docker build -t icverify-data-access -f ./Dockerfile . --no-cache

如果还是提示和旧microsoft/dotnet仓库相关的错误，执行命令清理BuildKit全量缓存：

docker buildx prune -af

也可以临时关闭BuildKit再尝试构建：

# Linux/macOS执行
DOCKER_BUILDKIT=0 docker build -t icverify-data-access .
# Windows PowerShell执行
$env:DOCKER_BUILDKIT=0; docker build -t icverify-data-access .

• 第二步：修正Dockerfile多阶段构建逻辑
  你修改后的Dockerfile多阶段逻辑错误，在只有runtime的基础镜像中执行dotnet publish操作会直接失败，你可以直接使用以下适配MCR镜像的正确版本，和你最初的业务逻辑完全对齐：

# 构建阶段使用sdk镜像
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build-env
WORKDIR /app

# 复制项目文件还原依赖
COPY MycompanyDAL/*.csproj ./
COPY MycompanyDAL/NuGet.config ./
RUN dotnet restore

# 复制全量代码构建发布
COPY MycompanyDAL/. ./
RUN dotnet publish -c Release -o out

# 运行阶段使用aspnet runtime镜像
FROM mcr.microsoft.com/dotnet/aspnet:5.0
WORKDIR /app
COPY --from=build-env /app/out .

ENV ASPNETCORE_URLS=http://+:8080
ENTRYPOINT ["dotnet", "MycompanyDAL.dll"]

注意：必须给镜像指定明确的版本标签，不要使用无标签的latest版本，避免出现版本不兼容问题

• 第三步：检查Docker镜像源配置
  如果以上操作都完成后依然拉取镜像失败，检查你的Docker daemon配置文件（Linux路径为/etc/docker/daemon.json，Windows/macOS可在Docker Desktop设置的Docker Engine页面查看），确认没有将mcr.microsoft.com的请求重定向到其他无效镜像源，修改配置后重启Docker服务再尝试构建即可。

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