构建ASP.NET Docker容器时遇镜像元数据解析失败问题求助

可能的原因及修复步骤 #

1. 统一镜像平台配置 #

你的build阶段指定了--platform=linux/arm64，但base阶段未明确平台，可能导致Docker拉取与本地架构不兼容的镜像，引发EOF错误。修改Dockerfile，统一指定平台：

FROM --platform=linux/arm64 mcr.microsoft.com/dotnet/aspnet:9.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM --platform=linux/arm64 mcr.microsoft.com/dotnet/sdk:9.0 AS build
ARG TARGETARCH
WORKDIR /src
....

2. 验证镜像标签有效性 #

尝试使用完整版本号标签替代9.0，避免模糊标签解析问题：

FROM --platform=linux/arm64 mcr.microsoft.com/dotnet/aspnet:9.0.0 AS base

3. 排查网络连接问题 #

EOF错误多由网络中断、代理拦截或防火墙限制导致：

• 运行命令测试MCR仓库连通性：curl -I https://mcr.microsoft.com/v2/dotnet/aspnet/manifests/9.0，若返回非200状态码，需检查网络配置。
• 若使用代理，确保Docker daemon已正确配置代理（修改/etc/docker/daemon.json或Docker Desktop代理设置）。
• 临时切换到国内镜像源（如阿里云、腾讯云）加速镜像拉取。

4. 手动拉取镜像测试 #

先单独拉取镜像确认是否能成功，排除Dockerfile本身的问题：

# 拉取指定平台的镜像
docker pull --platform=linux/arm64 mcr.microsoft.com/dotnet/aspnet:9.0

若手动拉取失败，说明问题出在镜像获取环节；若成功，再重新执行构建命令。

5. 更新Docker版本 #

旧版Docker可能不支持MCR最新的镜像格式或API，升级到Docker Engine 24.x及以上稳定版本后重试构建。

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