启用Docker BuildKit时提示缺少buildx组件的问题求助

问题说明 #

错误提示中的buidlx是拼写错误，实际需要的是Docker官方的buildx组件——它是支持BuildKit构建功能的核心工具，缺失或损坏会触发该报错。

解决步骤 #

1. 确保Docker版本符合要求 #

buildx需要Docker 19.03及以上版本支持，先检查当前版本：

docker --version

如果版本过低，执行以下命令更新Docker：

# 卸载旧版本
sudo apt remove docker docker-engine docker.io containerd runc

# 更新包索引并安装依赖
sudo apt update
sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加Docker软件源（以Linux Mint 21对应Ubuntu Jammy为例，其他版本替换为对应Ubuntu代号）
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu jammy stable"

# 安装最新版Docker CE
sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io

2. 安装/修复docker-buildx组件 #

先检查buildx状态：

docker buildx version

如果提示找不到命令或组件损坏，执行以下操作：

# 创建cli-plugins目录（如果不存在）
mkdir -p ~/.docker/cli-plugins

# 下载最新版buildx二进制文件（x86_64架构，其他架构替换对应下载链接）
curl -SL https://github.com/docker/buildx/releases/download/v0.11.2/buildx-v0.11.2.linux-amd64 -o ~/.docker/cli-plugins/docker-buildx

# 赋予执行权限
chmod +x ~/.docker/cli-plugins/docker-buildx

如果之前已有损坏的buildx文件，先删除再重新下载：

rm ~/.docker/cli-plugins/docker-buildx

3. 验证安装结果 #

执行以下命令确认buildx正常工作：

docker buildx version

能正常输出版本信息即为安装成功。

4. 重新执行构建命令 #

现在可以再次尝试原来的命令：

DOCKER_BUILDKIT=1 docker-compose up --build

可选：设置BuildKit为默认构建器 #

如果不想每次命令都加DOCKER_BUILDKIT=1环境变量，可以配置Docker默认启用BuildKit：

# 编辑daemon.json配置文件（不存在则创建）
sudo nano /etc/docker/daemon.json

添加以下内容：

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

保存退出后，重启Docker服务：

sudo systemctl restart docker

之后直接执行docker-compose up --build即可使用BuildKit构建。

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