Docker Compose部署ZooKeeper报错：无法访问datadir异常退出

这个错误几乎都是数据目录的权限或配置问题导致的，以下是针对性的解决方法：

1. 修复宿主机挂载目录的权限问题 #

ZooKeeper容器默认使用zookeeper用户（UID:1000）运行，如果宿主机的挂载目录权限不对，容器内进程无法读写数据目录就会报错。

• 直接修改宿主机目录权限，匹配容器内用户：

  chown -R 1000:1000 /path/to/your/zookeeper/data
  chown -R 1000:1000 /path/to/your/zookeeper/datalog
  

• 如果你用的是SELinux环境，挂载时添加:z或:Z标签（前者共享权限，后者私有权限）：

  volumes:
    - ./zookeeper/data:/data:z
    - ./zookeeper/datalog:/datalog:z
  

• 或者动态匹配当前宿主机用户，避免权限冲突：

  services:
    zookeeper:
      user: "${UID}:${GID}"
      # 其他配置...
  

2. 检查docker-compose.yml的datadir配置 #

确保容器内的dataDir和dataLogDir路径与挂载配置一致：

• 官方ZooKeeper镜像默认的环境变量是ZOO_DATA_DIR=/data和ZOO_DATALOG_DIR=/datalog，你的volume挂载必须对应这些路径。
• 正确的配置示例：

  version: '3.8'
  services:
    zookeeper:
      image: zookeeper:3.8
      ports:
        - "2181:2181"
      volumes:
        - ./zk-data:/data
        - ./zk-datalog:/datalog
      environment:
        ZOO_MY_ID: 1
        ZOO_DATA_DIR: /data
        ZOO_DATALOG_DIR: /datalog
        ZOO_SERVERS: server.1=0.0.0.0:2888:3888;2181
  

3. 排查宿主机环境问题 #

• 检查宿主机磁盘空间：执行df -h确认挂载目录所在磁盘有足够空间。
• 确认挂载目录不是只读模式：执行mount | grep /path/to/your/zookeeper/data查看挂载属性，确保没有ro标识。
• 确保没有其他进程占用该目录：比如之前的ZooKeeper容器残留进程，用lsof /path/to/your/zookeeper/data排查。

4. 避免相对路径的工作目录问题 #

如果挂载用了相对路径（比如./zk-data:/data），必须在docker-compose.yml所在目录执行docker-compose up，否则容器会找不到正确的宿主机目录。如果不确定，直接改用绝对路径挂载。

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