Docker 报错 name is already in use by container 怎么办？

原因与解法：容器名全局唯一（包括已停止的容器），你要用的名字被某个旧容器占着。处理：①docker ps -a 找到占名字的容器；②确认无用就 docker rm <名字> 删掉，还想留就先 docker rename 旧名 新名；③再重新启动你的容器。

处理流程

# 1. 找到冲突容器（停止的也算）
docker ps -a --filter "name=myapp"

# 2a. 直接删掉（确认无重要数据）
docker rm myapp
# 2b. 或改名保留
docker rename myapp myapp-backup

# 3. 重新创建
docker run -d --name myapp ...

运行中的容器先 docker stop 再 rm，或 docker rm -f 一步到位（会强制杀进程）。

删之前要确认的事

1. 可写层里有数据吗：docker diff myapp 看改动；有的话先 docker cp 拷出或 docker commit 存镜像
2. 卷不受影响：命名卷/绑定挂载的数据在容器外，删容器不丢

脚本化启动的防冲突写法

# 方式一：一次性容器用 --rm，退出即自动删除
docker run --rm myimage ./job.sh

# 方式二：先删再起（幂等部署脚本常用）
docker rm -f myapp 2>/dev/null || true
docker run -d --name myapp ...

# 方式三：不指定名字，让 Docker 自动生成
docker run -d myimage

为什么 CI 上特别容易撞

CI 每次跑同名容器，上次异常退出没清理就撞名。约定：CI 任务一律 --rm，或名字带构建号 --name myapp-$BUILD_ID。

观测云对照

容器频繁撞名/重建是架构信号。 观测云里看容器的生命周期事件与重启频率，异常的频繁重建、僵死容器堆积都能通过监控器告警暴露出来。

常见问题（FAQ）

Q：docker ps 看不到但还报冲突？
A：docker ps 只显示运行中的，停止的容器也占名字——必须 docker ps -a。

Q：compose 报类似冲突？
A：手工起过同名容器占了 compose 要用的名字，删掉那个外来容器即可；compose 项目内容器名带项目前缀，一般不冲突。

Q：能不能强制覆盖占用？
A：没有"覆盖"概念，必须先释放名字（rm 或 rename）。