Docker构建时查看镜像内容及dotnet restore失败排查

一、修复dotnet restore找不到SDK的错误 #

核心问题是build阶段误用了ASP.NET运行时镜像，而非包含SDK的开发镜像。aspnet镜像仅用于运行已编译的.NET应用，不支持dotnet restore、dotnet build等需要SDK的命令。

修改Dockerfile中build阶段的基础镜像：

• 针对.NET Core 3.1：将FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS build改为FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
• 针对.NET 6：将FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS build改为FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build

修改后的build阶段开头示例：

FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
#FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build

二、构建过程中查看镜像内容的方法 #

方法1：在Dockerfile中添加临时查看命令 #

在需要排查的步骤前后插入RUN命令输出目录内容，比如：

WORKDIR /src

COPY NuGet.Config . 
COPY src/AppPortal.Web/*.csproj AppPortal.Web/

# 添加该行查看当前目录下的所有内容
RUN ls -la /src

RUN dotnet restore AppPortal.Web/AppPortal.Web.csproj --configfile NuGet.Config

构建时会直接输出该目录的文件列表，帮助确认文件是否正确复制到镜像内。

方法2：临时启动中间镜像排查 #

构建失败时，Docker会保留失败步骤之前的镜像（错误信息中会显示类似---> 48358f7e2161的镜像ID），执行以下命令进入镜像的交互式shell：

docker run -it 48358f7e2161 /bin/bash

进入后可执行ls、pwd、dotnet --list-sdks等命令，全面检查镜像内的环境配置和文件结构。

额外验证点 #

• 进入中间镜像后执行dotnet --list-sdks，确认SDK已正确安装
• 检查/src目录下的NuGet.Config文件是否存在，私有源配置是否正确

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