Docker 23.0.1启用BuildKit时Buildx缺失/损坏的解决咨询

方案1：重新安装完整的buildx组件 #

组件损坏或缺失是常见触发原因，按以下步骤重新安装：

• 先卸载现有异常的buildx：docker buildx uninstall
• 创建Docker CLI插件目录（若不存在）：mkdir -p ~/.docker/cli-plugins
• 前往docker/buildx的官方发布页面，下载与你的系统架构、Docker 23.0.1兼容的buildx二进制包（推荐v0.10.x系列版本），将文件保存到~/.docker/cli-plugins/目录下并命名为docker-buildx
• 赋予执行权限：chmod +x ~/.docker/cli-plugins/docker-buildx
• 验证安装结果：docker buildx version，若输出版本信息则安装成功

方案2：检查并修复BuildKit配置 #

确保Docker daemon的BuildKit配置与buildx兼容：

• 编辑（或创建）Docker daemon配置文件/etc/docker/daemon.json，添加以下内容：

  {
    "features": {
      "buildkit": true
    }
  }
  

• 重启Docker服务：systemctl restart docker（Linux）；Windows/macOS用户可在Docker Desktop界面点击重启按钮
• 验证BuildKit状态：docker buildx inspect，若返回正常的builder信息则配置生效

方案3：切换到Docker Desktop（桌面环境用户） #

手动安装的Docker引擎可能存在组件依赖缺失，Docker Desktop默认集成了完整的buildx和BuildKit：

• 卸载当前手动安装的Docker引擎及buildx组件
• 安装对应版本的Docker Desktop 23.0.1，安装完成后自动完成buildx和BuildKit的配置
• 打开Docker Desktop设置面板，确认「Use BuildKit for building」选项已勾选

方案4：指定buildx执行构建命令 #

确保构建时调用正确的buildx组件以启用并行构建：

• 直接使用buildx命令执行构建：docker buildx build -t your-image-tag .
• 若需要创建新的builder实例优化并行能力，执行：docker buildx create --use，之后再运行构建命令即可启用并行构建

完成上述操作后，原有的「BuildKit is enabled but the buildx component is missing or broken」错误会消失，回退构建器产生的警告也会消除，并行构建功能可正常使用。

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