Docker Stack部署报错volumes.dbdata must be a mapping or null的原因与解决

错误原因 #

这个问题我之前也碰到过，核心是Docker Compose对命名卷的定义格式要求没满足：
在volumes块里，命名卷（比如你定义的dbdata）的配置必须是一个YAML映射（键值对结构），但你直接写了字符串/new/folder，这种格式Docker Compose无法识别，所以抛出了volumes.dbdata must be a mapping or null的错误。

两种修复方案 #

根据你要把本地/new/folder映射到容器内路径的需求，推荐以下两种可行方案：

方案一：用命名卷绑定本地路径（适合需要Docker管理卷的场景）

如果想保留命名卷的形式，同时指定本地存储位置，需要通过driver_opts配置local驱动的绑定参数：

version: "3"
services:
  db:
    image: new:1
    volumes:
      - "dbdata:/some/path/to/folder"
    ports:
      - "1234:1234"
    networks:
      - webnet
volumes:
  dbdata:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /new/folder
networks:
  webnet:

这里通过driver_opts明确告诉Docker，把本地/new/folder绑定为dbdata命名卷的存储位置，完全符合Compose的语法规则。

方案二：直接使用绑定挂载（更简洁的本地路径映射）

如果不需要命名卷，直接在服务的volumes里写本地路径和容器路径的映射就行，同时删掉volumes块里的dbdata定义：

version: "3"
services:
  db:
    image: new:1
    volumes:
      - "/new/folder:/some/path/to/folder"
    ports:
      - "1234:1234"
    networks:
      - webnet
networks:
  webnet:

这种方式是最直接的绑定挂载，不需要额外配置命名卷，适合简单的本地目录映射场景。

验证修复 #

修改完成后，重新执行部署命令：

docker stack deploy --compose-file docker-compose.yml service_name

应该就能正常部署了。

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