docker network_error ai_generated true

守护进程响应错误：端点名称 container_name 已存在于网络 bridge 中

Error response from daemon: endpoint with name container_name already exists in network bridge

ID: docker/container-name-orphaned-network-endpoint

其他格式: JSON · Markdown 中文 · English
82%修复率
85%置信度
1证据数
2024-03-15首次发现

版本兼容性

版本状态引入弃用备注
Docker 20.10.17 active — — —
Docker 24.0.6 active — — —
Docker 25.0.0 active — — —

根因分析

容器从网络中断开时未正确移除端点，导致网络内部状态中残留了过期的端点条目。

English

A container was disconnected from a network without properly removing the endpoint, leaving a stale endpoint entry in the network's internal state.

generic

官方文档

https://docs.docker.com/engine/reference/commandline/network_disconnect/

解决方案

  1. 使用 'docker network disconnect -f bridge container_name' 显式断开容器与网络的连接，以移除过期的端点。
  2. 如果容器已不存在，使用 'docker network prune' 清理所有未使用的网络及其孤立的端点。
  3. 使用 'docker network inspect bridge' 检查网络端点列表，然后通过 'docker network disconnect -f bridge <container_id>' 手动断开每个过期的容器。

无效尝试

常见但无效的做法:

  1. 70% 失败

    Restarting Docker does not clean up stale endpoints in individual networks; it only resets the daemon state but persistent network data remains.

  2. 90% 失败

    The 'bridge' network is a default network that cannot be removed; this command will fail with 'Error response from daemon: network bridge is a pre-defined network'.

  3. 60% 失败

    The container may already be removed, but the stale endpoint persists; force removal does not clean up orphaned endpoints in the network.