在Windows上构建Linux容器时遇平台不匹配警告，如何解决？

在Windows系统上构建基于Linux的容器时，会触发如下平台不匹配警告：

[Warning] The requested image's platform (linux/amd64) does not match the detected host platform (windows/amd64) and no specific platform was requested

原因很明确：Windows主机默认识别的平台是windows/amd64，而你要构建的容器依赖linux/amd64平台镜像，两者架构平台不匹配，且构建命令中未明确指定目标平台，因此Docker抛出该警告。

• 临时指定平台（单次构建）
  执行构建命令时，通过--platform参数明确指定目标平台：

  docker build --platform linux/amd64 -t your-image-tag .
  

  替换your-image-tag为你的镜像标签，.表示当前目录为构建上下文。

• 永久配置默认平台
  编辑Docker的守护进程配置文件daemon.json（Windows系统默认路径为C:\ProgramData\Docker\config\daemon.json），添加以下配置：

  {
    "experimental": true,
    "platforms": ["linux/amd64"]
  }
  

  保存文件后重启Docker服务，后续构建默认会使用指定的linux/amd64平台，无需每次手动指定。

• 切换到WSL2后端（推荐）
  如果你的Windows系统支持WSL2（Windows Subsystem for Linux 2），在Docker设置中切换到WSL2后端。这种模式下Docker直接基于Linux环境运行，构建Linux容器时会自动匹配平台，从根源减少这类警告出现的概率。

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