Docker Compose exec容器命令无响应问题咨询：原因与解决方法

环境信息 #

CentOS Linux release 8.5.2111
Docker version 23.0.1
Docker Compose version 2.3.4

Docker Compose 配置 #

version: "3.9"

services:

  web:
    image: python:3.9
    hostname: web
    container_name: web
    restart: always
    stdin_open: true
    tty: true
    depends_on:
      - mariadb
    build:
      context: .
      dockerfile: Dockerfile_web
    volumes:
      - ./facility_iot:/service
      - ./tmp:/tmp
    # command: sh -c "cd /service && python manage.py runserver 0.0.0.0:8000"
    command: sh -c "cd /service && gunicorn --worker-tmp-dir /tmp --bind 0.0.0.0:8000 --timeout=60 config.wsgi:application"
    # command: sh -c "cd /service && python manage.py makemigrations && python manage.py migrate"

  mariadb:
    image: mariadb
    hostname: mariadb
    container_name: mariadb
    cpu_count: 4
    restart: always
    environment:
      MARIADB_ROOT_PASSWORD: [PASSWORD]
      TZ: Asia/Seoul
    volumes:
      - ./mariadb/data:/var/lib/mysql
      - ./mariadb/init.sql:/init.sql
    ports:
      - "3306:3306"
    command: --init-file /init.sql

  nginx:
    image: nginx
    hostname: nginx
    container_name: nginx
    cpu_count: 4
    restart: always
    depends_on:
      - web
      - grafana
    volumes:
      - ./nginx/conf.d/default.conf:/etc/nginx/conf.d/default.conf
      - ./nginx/conf.d/nginx.conf:/etc/nginx/nginx.conf
      - ./nginx/static:/static
    ports:
      - "8000:8000"

  grafana:
    image: grafana/grafana
    hostname: grafana
    container_name: grafana
    cpu_count: 1
    restart: always
    depends_on:
      - mariadb
    volumes:
      - ./grafana/conf:/usr/share/grafana/conf
      # - ./grafana/data:/var/lib/grafana

问题现象 #

执行docker compose up --build -d启动服务后：

• 使用docker exec -it mariadb /bin/bash可正常进入MariaDB容器并执行命令
• 使用docker compose exec mariadb bash进入容器后，执行任何命令（如ls、mysql -u root -p）均无响应，只能强制终止

问题解答 #

1. 如何修复该问题？ #

尝试以下几种方案：

• 添加交互式终端参数：执行docker compose exec -it mariadb bash，显式指定-it参数分配终端会话，这是最直接的修复方式。
• 移除资源限制测试：暂时删除mariadb服务中的cpu_count:4配置，重启服务后再次测试，排查是否为资源分配导致的命令阻塞。
• 升级Docker Compose版本：当前使用的2.3.4版本存在部分exec命令的已知bug，升级到2.x系列的最新稳定版本可解决兼容性问题。
• 清理Compose缓存：执行docker compose down -v清理容器和卷，再重新构建启动服务，排查是否为配置缓存导致的异常。

2. 为什么docker exec与docker compose exec的表现存在差异？ #

两者核心差异体现在执行逻辑和默认参数上：

• 终端参数默认值不同：你实际使用的docker exec -it带了交互式终端参数，而docker compose exec mariadb bash未加-it，导致容器未分配标准输入输出终端，命令无法正常交互，表现为无响应。
• 容器定位逻辑不同：docker exec直接通过容器ID/名称定位目标容器，而docker compose exec需要先查询Compose项目的服务关联关系，若项目配置存在缓存或命名冲突，可能导致执行环境异常。
• 环境变量传递逻辑不同：docker compose exec会默认传递Compose配置中定义的服务环境变量，而docker exec仅传递容器内部原生环境变量，部分环境变量冲突可能引发命令执行阻塞。

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