多目录Docker Compose执行down命令失效，如何单独停止微服务容器？

问题根源 #

Docker Compose 默认以当前工作目录的名称作为项目标识。从根目录/var/www/html启动所有服务时，项目名是html；而进入单个微服务目录执行docker compose down时，项目名变成了微服务目录的名称（比如psychology）。由于项目标识不匹配，Compose 无法识别根目录启动的对应容器，导致无法停止。

解决方案：为每个微服务指定固定项目名 #

为每个微服务的docker-compose.yml添加固定项目名称配置，确保无论从哪个目录启动/停止，Compose 都能识别到对应的容器。

步骤1：修改微服务的docker-compose.yml #

在每个微服务的docker-compose.yml最顶部添加name字段（Docker Compose v2.20+ 支持），指定该微服务的唯一项目名，以示例中的psychology服务为例：

name: psychology  # 新增：固定项目名，与微服务标识一致
version: '3'
networks:
  common_network:
    external: true
  psychology_network:
    name: psychology_network
    driver: bridge

# 以下原有服务配置保持不变
services:
  psychology_php:
    build:
      context: ${PSYCHOLOGY_DIRECTORY}
      dockerfile: php8.1.Dockerfile
    image: psychology_php
    container_name: "psychology_php"
    restart: unless-stopped
    tty: true
    networks:
      - psychology_network
    volumes:
      - ${PSYCHOLOGY_DIRECTORY}:/var/www/html
    ports:
      - "${PSYCHOLOGY_PHP_PORT}:9000"
  # 其余服务配置省略...

步骤2：重新启动所有服务 #

从根目录执行以下命令，用新的项目名重新启动所有服务：

docker compose up -d

步骤3：验证单个服务停止功能 #

进入目标微服务目录（比如/var/www/html/psychology），执行：

docker compose down

此时该微服务对应的psychology_php、psychology_nginx、psychology_mysql容器会被正确停止并移除。

兼容低版本 Compose 的替代方案 #

如果使用 Docker Compose 版本低于v2.20，可以通过环境变量指定项目名：

• 在每个微服务目录下创建.env文件，添加：COMPOSE_PROJECT_NAME=psychology
• 或者执行停止命令时直接指定项目名：docker compose --project-name psychology down

内容的提问来源于stack exchange，提问作者M a m a D