Docker Compose绑定文件报错：volume需为映射而非字符串/数组

错误原因分析 #

1. "volume must be a mapping not a string" 错误 #

这个错误通常是因为你把绑定挂载的字符串格式写在了顶级volumes节点下。顶级volumes节点的作用是定义命名卷，需要用映射结构（比如指定驱动、驱动选项等），而不是直接写宿主机-容器路径的字符串。

错误写法示例：

version: '3.8'
volumes:
  - ./host/path:/container/path  # 错误：顶级volumes不能用数组字符串格式

services:
  app:
    image: nginx

2. "service 'volumes' must be a mapping not an array" 错误 #

这个错误是因为你把volumes当成了一个独立的服务放在services节点下，而正确的做法是volumes是每个服务内部的子节点，用于配置该服务的挂载。

错误写法示例：

version: '3.8'
services:
  app:
    image: nginx
  volumes:  # 错误：volumes不能作为独立服务
    - ./host/path:/container/path

正确配置方式 #

绑定挂载应该放在具体服务的volumes子节点下，用数组字符串格式；如果需要命名卷，再在顶级volumes节点定义：

绑定挂载（直接映射宿主机文件/目录） #

version: '3.8'
services:
  app:
    image: nginx
    volumes:
      - ./host/config.conf:/etc/nginx/conf.d/default.conf  # 正确：服务内的volumes用数组字符串
      - ./host/html:/usr/share/nginx/html

命名卷（配合顶级volumes定义） #

version: '3.8'
volumes:
  nginx_data:  # 正确：顶级volumes是映射结构，定义命名卷
    driver: local

services:
  app:
    image: nginx
    volumes:
      - nginx_data:/usr/share/nginx/html  # 服务内引用命名卷
      - ./host/config.conf:/etc/nginx/conf.d/default.conf  # 同时混用绑定挂载

额外注意事项 #

• 确认宿主机路径的相对路径是否正确：Docker Compose默认以docker-compose.yml所在目录为基准解析相对路径。
• 路径中的特殊字符（比如空格）需要用引号包裹，例如：- "./host/my dir:/container/my dir"。

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