Docker Compose 中网络冲突源于默认网络名 ${PROJECT_NAME}_default 重复，解决关键是显式定义自定义网络并指定唯一项目名：在 docker-compose.yml 中声明 networks 块并引用，启动时用 -p 或 COMPOSE_PROJECT_NAME 隔离，冲突后通过 docker-compose down 和 docker network rm 清理残留网络。
在 Docker Compose 中，多个项目使用相同服务名或默认网络名时，容易触发网络名冲突（如 myapp_default 已存在），导致 docker-compose up 失败。解决核心在于**显式控制网络命名与作用域**，而非依赖默认行为。
明确指定自定义网络名称
在 docker-compose.yml 中，通过 networks 顶层键定义独立网络，并在服务中引用它，避免默认的 ${PROJECT_NAME}_default 自动创建：
- 删除
services.xxx.networks中的default或空数组写法 - 添加自定义网络块，例如：
networks:<br> app-net:<br> name: myproject_v2_network<br> driver: bridge
- 在服务中引用：
services:<br> web:<br> networks:<br> - app-net
为每个项目设置唯一 Compose 项目名
Compose 默认用目录名作为项目名，若多个项目目录名相同（或未指定），会复用同一套资源（含网络）。可通过以下方式隔离：
- 启动时用
-p参数指定项目名：docker-compose -p myapp-prod up -d - 或设置环境变量：
export COMPOSE_PROJECT_NAME=myapp-staging，再运行docker-compose up - 项目名会成为网络前缀（如
myapp-prod_app-net），彻底避免跨项目冲突
清理残留网络（冲突发生后）
若已报错 “network xxx already exists”，说明旧网络残留。需手动清理（注意：正在使用的网络无法删除）：
- 列出所有网络：
docker network ls | grep your-pattern - 查看某网络是否被容器占用：
docker network inspect myproject_default→ 检查Containers字段 - 停用并删除无用网络：
docker-compose down（先停止当前项目）docker network rm myproject_old_network
避免使用默认网络的替代方案
若无需多服务互联，可让服务直接使用 host 或 none 网络模式；若需简单互通，也可启用 network_mode: "service:other-service" 复用已有容器网络，跳过独立网络创建环节。
