docker-compose构建时moby/buildkit:buildx-stable-1容器名称冲突问题的原因及解决方法咨询

问题背景 #

我有如下docker-compose.yml配置：

version: "3.8"

services:
  proxy:
    container_name: proxy
    extra_hosts:
      - "host.docker.internal:host-gateway"
    build:
      context: proxy
      dockerfile: Dockerfile
    volumes:
      - ./proxy/certificate:/usr/cert
    ports:
      - "443:443"
  ui:
    container_name: ui
    restart: always
    build:
      context: frontend
    ports:
      - "80:80"
  backend:
    container_name: backend
    restart: always
    build:
      context: backend
    ports:
      - "8000:8000"
    environment:
      - API_KEY
      - GOLD_TOKEN

然后使用以下shell脚本构建：

#! /bin/bash

docker-compose build
docker-compose up -d

但运行脚本时，Docker尝试创建moby/buildkit:buildx-stable-1容器，该容器启动失败，构建时出现如下错误：

=> ERROR [internal] booting buildkit 0.9s
=> => pulling image moby/buildkit:buildx-stable-1 0.8s
=> => creating container buildx_buildkit_gallant_newton0 0.1s
[+] Building 0.9s (1/1) FINISHED
=> CANCELED [internal] booting buildkit 0.9s
=> => pulling image moby/buildkit:buildx-stable-1 0.8s
=> => creating container buildx_buildkit_gallant_newton0
Error response from daemon: Conflict. The container name "/buildx_buildkit_gallant_newton0" is already in use by container "8b56bc95c1e26b736d0f297236adce9766f1363b1f94b35fcbc29ac96b4b61d3". You have to remove (or rename) that container to be able to reuse that name.

想请教各位，这个问题是什么原因导致的，以及如何避免这种容器名称冲突？

原因分析 #

这个问题通常和Docker Buildx的残留容器或构建中断有关：

• 现在Docker Compose默认使用Buildx作为构建后端，它会创建临时buildkit容器来处理构建任务。如果之前的构建被意外中断（比如手动终止脚本、网络波动），这些临时容器可能没被自动清理，导致名称被占用。
• 偶尔也会因为Buildx的随机命名逻辑，在重复构建或多项目并行构建时出现名称冲突，但更常见的还是残留容器的问题。

解决方法 #

这里有几个实用的解决方案：

1. 直接清理冲突的残留容器
   手动删除那个占用名称的容器即可：

   docker rm -f buildx_buildkit_gallant_newton0
   

   如果你不确定具体容器名，也可以批量清理所有buildx相关的残留容器：

   docker ps -a | grep buildx_buildkit | awk '{print $1}' | xargs docker rm -f
   

2. 重置Docker Buildx构建器
   彻底重置Buildx的构建环境，让它重新创建干净的构建容器：

   docker buildx rm default
   docker buildx create --use
   

3. 临时禁用Docker Buildx
   如果你暂时不需要Buildx的功能，可以强制Compose使用传统构建后端，修改脚本加上环境变量：

   #! /bin/bash
   
   export COMPOSE_DOCKER_CLI_BUILD=0
   docker-compose build
   docker-compose up -d
   

   或者单次构建时临时指定：

   COMPOSE_DOCKER_CLI_BUILD=0 docker-compose build
   

4. 自定义Buildx构建器名称
   手动创建带固定名称的Buildx构建器，避免随机名称冲突：

   docker buildx create --name my-project-builder --use
   

   之后构建会使用你指定的名称生成容器，大幅降低冲突概率。

备注：内容来源于stack exchange，提问作者Jackie