Docker构建失败：提示.NET SDK 6.0.403下runtimeconfig.json为空

问题概述 #

执行以下命令构建Docker镜像失败：

docker build --no-cache --force-rm -f [DockerFile路径] -t [镜像名]:latest

报错信息：

Invalid runtimeconfig.json [/usr/share/dotnet/sdk/6.0.403/dotnet.runtimeconfig.json] [/usr/share/dotnet/sdk/6.0.403/dotnet.runtimeconfig.dev.json] : The document is empty

本地环境信息：

• Docker版本：Docker version 20.10.21, build baeda1f
• 本地.NET SDK版本：7.0.100，同时已安装6.0.403 SDK，本地dotnet.runtimeconfig.json内容正常，此前构建操作可正常完成，当前在还原阶段触发错误。

解决方案 #

• 重新拉取对应版本的官方.NET SDK镜像
  报错指向容器内的SDK配置文件为空，大概率是基础镜像拉取不完整或损坏。执行命令拉取指定版本的官方镜像：

  docker pull mcr.microsoft.com/dotnet/sdk:6.0.403
  

  同时确保Dockerfile的FROM指令使用该具体版本镜像，而非模糊的6.0标签。

• 清理Docker缓存与无效资源
  即便使用了--no-cache，Docker的基础镜像缓存仍可能存在异常。执行以下命令清理：

  docker system prune -a
  

  清理完成后重新执行构建命令。

• 排查Dockerfile是否损坏SDK文件
  检查Dockerfile中是否存在删除、覆盖/usr/share/dotnet/sdk/6.0.403/目录下文件的指令（如RUN rm、错误的COPY操作），确保构建过程中不会修改SDK自带的配置文件。

• 临时验证容器内文件状态
  在Dockerfile的还原步骤（如RUN dotnet restore）前添加以下指令，查看容器内的配置文件内容：

  RUN cat /usr/share/dotnet/sdk/6.0.403/dotnet.runtimeconfig.json && cat /usr/share/dotnet/sdk/6.0.403/dotnet.runtimeconfig.dev.json
  

  若输出为空，说明基础镜像确实存在问题，更换镜像源或重新拉取镜像即可。

• 对齐项目与容器内的.NET版本
  本地使用.NET 7 SDK，但构建依赖.NET 6 SDK，需确保项目的目标框架（Target Framework）与容器内的SDK版本匹配，避免版本不兼容导致的异常。

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