本地Docker构建自托管DevOps Agent拉取基础镜像报错如何解决

该错误的核心是Docker当前运行的平台与Dockerfile中指定的基础镜像mcr.microsoft.com/windows/servercore:ltsc2019的目标平台不匹配，无法找到对应架构/系统版本的镜像清单。

按如下顺序依次尝试即可解决：

• 切换Docker运行模式
  Windows版Docker Desktop默认运行Linux容器，无法拉取Windows系基础镜像。右键点击任务栏中的Docker Desktop图标，选择「切换到Windows容器」，等待服务重启完成后重新执行构建命令。
• 显式指定构建平台参数
  如果已经处于Windows容器模式仍报错，可在构建命令中明确指定匹配基础镜像的平台：
  docker build --platform windows/amd64 -t dockeragent:latest .
• 调整基础镜像版本
  如果你使用的是Windows 11/Windows Server 2022及以上版本系统，或者Arm架构Windows设备，ltsc2019版本的servercore镜像没有对应适配版本，可修改Dockerfile中的基础镜像标签为匹配你系统的版本，比如mcr.microsoft.com/windows/servercore:ltsc2022后重新构建。
• 临时关闭BuildKit重试
  如果上述操作都无效，可临时关闭Docker BuildKit组件后重试：

1. PowerShell中执行命令设置环境变量：$env:DOCKER_BUILDKIT=0
2. 重新执行原始构建命令即可

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