Docker Compose up偶发容器未加入配置网络问题求助

排查与修复步骤： #

• 升级Docker Compose版本：旧版本存在外部网络处理的偶发Bug，执行docker compose version确认版本，建议升级到v2.10及以上。升级方式：

  • Debian/Ubuntu：sudo apt update && sudo apt install docker-compose-plugin
  • macOS（Homebrew）：brew upgrade docker-compose
  • Windows：通过Docker Desktop的更新功能升级

• 强制重建容器网络关联：启动时添加--force-recreate参数，清除容器残留的异常网络配置：

  docker compose up -d --force-recreate backend_1
  

• 校验外部网络名称一致性：DB Compose创建的网络默认名称为{所在目录名}_db（比如DB文件在postgres目录下，网络名是postgres_db），后端Compose中postgres_db必须与这个实际名称完全匹配。执行docker network ls可查看所有网络名称，若不匹配，修改后端Compose的网络名称或给DB网络指定固定名称：
  在DB Compose的networks部分添加name字段：

  networks:
    db:
      name: postgres_db
  

• 添加健康检查与启动依赖：给DB容器添加健康检查，确保后端容器仅在DB完全就绪后启动，避免隐性网络问题：
  DB Compose的db服务添加：

  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres"]
    interval: 5s
    timeout: 5s
    retries: 5
  

  后端Compose中添加DB服务引用与依赖：

  services:
    db:
      external: true
      container_name: postgres
    backend_1:
      # ... 原有配置
      depends_on:
        db:
          condition: service_healthy
  

• 查看日志定位异常：查看容器启动日志docker logs backend_1，以及Docker daemon日志（Linux：journalctl -u docker.service），寻找网络相关的错误提示。

原始配置参考： #

DB Compose文件：

version: "3.5"

services:
  db:
    restart: always
    image: postgres:15.2-alpine
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./postgres.conf:/etc/postgresql/postgresql.conf:ro
    environment:
      - POSTGRES_PASSWORD=${DB_MASTER_PWD}
    command: postgres -c config_file=/etc/postgresql/postgresql.conf -c logging_collector=on -c log_directory=/logs/postgresql -c log_filename=postgresql.log -c log_statement=ddl
    ports:
      - 127.0.0.1:5432:5432
    networks:
      - db
    container_name: postgres

volumes:
  postgres_data:

networks:
  db:

Backend(1) Compose文件：

version: "3.5"

services:
  backend_1:
    restart: always
    build:
      context: ${DOCKER_FILES_PATH}/customer-compose/backend/
      dockerfile: Dockerfile
      args:
        ...
    image: ${BE_IMAGE_NAME}
    volumes:
      ...
    networks:
      - postgres_db
    environment:
      ...
    container_name: backend_1

networks:
  postgres_db:
    external: true

内容的提问来源于stack exchange，提问作者weddingcrasher