如何在Docker Compose中持久化PostgreSQL数据？解决初始化报错

报错信息 #

initdb: error: directory "/var/lib/postgresql/data" exists but is not empty
initdb: hint: If you want to create a new database system, either remove or empty the directory "/var/lib/postgresql/data" or run initdb with an argument other than "/var/lib/postgresql/data".

问题原因 #

你的Docker Compose配置里把本地目录挂载到了PostgreSQL的/var/lib/postgresql/data/pgdata子目录，但PostgreSQL默认会使用/var/lib/postgresql/data作为数据根目录。容器启动时，PostgreSQL的初始化脚本会检查这个根目录是否为空，而官方镜像的这个目录本身自带一些默认文件（比如README、配置样本），加上你挂载子目录后根目录并没有被覆盖，就会触发“目录非空”的报错。另外也可能是之前的容器残留了数据文件，或者镜像更新后目录结构发生了变化。

解决方案 #

1. 修正挂载路径 #

把挂载目标改为PostgreSQL的默认数据根目录/var/lib/postgresql/data，而不是子目录。这样本地目录会直接覆盖容器内的data目录，避免根目录存在多余文件。修改后的volumes配置如下：

volumes:
  - ./db/pgdata:/var/lib/postgresql/data

2. 清理本地残留数据（可选但推荐） #

如果之前的本地./db/pgdata目录已经有残留文件，先清理干净：

# 停止并删除现有容器
docker-compose down
# 清空本地数据目录
rm -rf ./db/pgdata/*
# 或者直接删除目录后重建
rm -rf ./db/pgdata && mkdir -p ./db/pgdata

3. 修复健康检查命令 #

原配置里的pg_isready参数不完整，缺少指定用户名，会导致健康检查失败。修正后的健康检查配置：

healthcheck:
  test: ["CMD", "pg_isready", "-q", "-d", "my_db", "-U", "postgres"]
  timeout: 45s
  interval: 10s
  retries: 10

完整修正后的docker-compose.yml #

version: '3.9'

services:
  db:
    image: postgres
    restart: always
    ports:
      - 5432:5432
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: pgpassword
      POSTGRES_DB: my_db
    healthcheck:
      test: ["CMD", "pg_isready", "-q", "-d", "my_db", "-U", "postgres"]
      timeout: 45s
      interval: 10s
      retries: 10
    volumes:
      - ./db/pgdata:/var/lib/postgresql/data

  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080

验证方法 #

1. 启动容器：docker-compose up -d
2. 查看PostgreSQL日志确认正常启动：docker-compose logs -f db，看到类似database system is ready to accept connections的日志就说明启动成功
3. 访问Adminer：打开浏览器输入http://localhost:8080，用配置里的用户名、密码、数据库名连接，新建一张测试表后重启容器，确认表依然存在，说明数据持久化生效。

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