Docker 删除镜像时报 image is referenced in multiple repositories

按 IMAGE ID 删除本地 Docker 镜像，收到 image is referenced in multiple repositories，即使 docker ps -a 已经没有容器，错误仍然存在。此时应查看同一镜像是否有多个名称引用，不要把提示中的 repositories 直接理解成远端仓库正在占用镜像。

以下针对 docker image rm 的本地镜像引用冲突。报错若明确说容器正在使用镜像，或涉及其他依赖，应按那条错误继续判断；“多个标签”和“容器使用中”不是同一个条件。

同一个 ID 可以出现在多行

先列出本地引用，并保留完整 ID：

docker image ls --no-trunc

可能看到两个不同名称指向同一个 IMAGE ID，例如 team/app:old 与 archive/app:keep。这表示两个名称引用同一份镜像，不代表存在两份完全独立的磁盘数据。

针对准备移除的名称做精确检查：

docker image inspect team/app:old --format '{{.Id}} {{json .RepoTags}}'
docker image inspect archive/app:keep --format '{{.Id}} {{json .RepoTags}}'

名称都是占位值。确认完整 ID 相同，再决定哪个引用确实不再需要。使用远程 Docker context 时，查的是所连接 Engine 的镜像，不是自动检查当前电脑或 Docker Hub。

按不再需要的名称解除引用

若目的只是删除 team/app:old 这个旧名称，同时保留已经确认的 archive/app:keep，可以对名称操作：

docker image rm team/app:old

镜像还有其他标签时，这一步只解除指定标签；输出通常包含 Untagged，镜像内容仍可通过保留的标签使用。最后一个引用被移除时，命令才可能进一步删除镜像，且仍受容器使用等条件约束。

因此，不能看到磁盘空间没有明显下降就认为命令失败。多标签并不各自占一份完整镜像空间，共用内容也不能通过解除其中一个名称立即全部回收。

不要把示例换成遍历所有 IMAGE ID 再加 --force 的脚本。按 ID 强制移除可能一起解除多个名称，破坏其他项目或回退流程仍在使用的引用。错误提示允许强制操作，不代表必须选择它。

此处的 docker image rm 不会删除远端 registry 中的镜像。远端生命周期、权限或保留策略需要在对应仓库独立管理；无需为了本地多标签冲突去删除 Docker Hub 仓库。

检查保留引用，并留下可恢复路径

操作前记录旧标签对应的完整镜像 ID，确认仍需保留的标签指向同一内容。如果镜像是无法重新构建或拉取的唯一副本，先按现有离线镜像备份流程保留它，不要以“应该还能拉取”作为恢复保证。

操作后重新列出镜像，核对目标标签已经解除、保留标签仍指向原 ID。对被删除的标签执行 inspect 应报告找不到，而保留标签的 inspect 应成功；这两个结果一起说明引用变更符合预期。

只解除标签且镜像内容仍可访问时，可重新加回原名称：

docker image tag archive/app:keep team/app:old

恢复前再次检查 archive/app:keep 的完整 ID 与原记录一致，并确认 team/app:old 没有被其他流程改指向新版本。标签可能被移动，不能只凭名称相同就当作原镜像。

如果镜像内容也已删除，则需要从可信备份、固定摘要的仓库内容或可重复构建中恢复。重新创建一个同名 tag 本身不会找回已经删除的镜像，也不会自动恢复被移除的容器。