Docker Postgres版本不兼容问题及敏感数据卷备份咨询

问题详情 #

执行docker system prune --all后，运行docker compose up时activitiesdb容器持续重启，报错如下：

PostgreSQL Database directory appears to contain a database; Skipping initialization activitiesdb  |  activitiesdb  | 2023-11-15 03:07:41.045 UTC [1] FATAL:  database files are incompatible with server activitiesdb  | 2023-11-15 03:07:41.045 UTC [1] DETAIL:  The data directory was initialized by PostgreSQL version 15, which is not compatible with this version 16.1 (Debian 16.1-1.pgdg120+1).

本地环境指定postgres:15镜像可正常启动容器，但生产环境配置完全相同却出现上述版本不兼容错误。由于数据卷包含敏感数据无法直接删除，需解决两个核心需求：

• 如何备份单个Docker数据卷
• 如何解决PostgreSQL版本不兼容导致的容器重启问题

脱敏后的docker-compose.yml配置如下：

volumes:
  db_quotes:   
    driver: local
  db_activities:   
    driver: local
     
quotes-db:
    container_name: quotesdb
    image: postgres:15
    restart: always
    build:
      context: .
      dockerfile: ./QuotesMicroservice/sql/Dockerfile
    ports:
      - "5480:5432"
    volumes:
      - ./QuotesMicroservice/sql:/docker-entrypoint-initdb.d
      - db_quotes:/var/lib/postgresql/data
    networks:
        - app-network

activities-db:
    container_name: activitiesdb
    image: postgres:15
    restart: always
    environment:
        - POSTGRES_USER=postgres
        - POSTGRES_PASSWORD=postgres
        - POSTGRES_DB_NAME=activitiesdb
    ports:
        - '5433:5432'
    volumes: 
        - db_activities:/var/lib/postgresql/data
    networks:
      - app-network

解决方案 #

一、备份单个Docker数据卷 #

使用临时容器挂载目标数据卷和本地目录，通过tar打包备份：

1. 备份db_activities卷到当前目录下的activities_db_backup文件夹：

docker run --rm -v db_activities:/data -v $(pwd)/activities_db_backup:/backup busybox tar cvzf /backup/db_activities_backup.tar.gz /data

2. 验证备份完整性（可选）：

mkdir -p ./backup_verify && tar xzf ./activities_db_backup/db_activities_backup.tar.gz -C ./backup_verify

检查./backup_verify/data目录下的文件结构是否完整。

二、解决PostgreSQL版本不兼容问题 #

报错核心是数据目录由PG 15初始化，但容器实际运行的是PG 16.1，即使docker-compose.yml指定了postgres:15，可能是镜像标签指向变更或build配置覆盖导致，可按以下步骤排查修复：

1. 强制指定PG 15的具体小版本镜像

避免postgres:15标签因镜像仓库更新指向意外版本，改用固定小版本（如15.7）：
修改docker-compose.yml中两个数据库服务的image字段：

image: postgres:15.7

重新拉取镜像并启动容器：

docker compose pull
docker compose up -d

2. 检查build配置是否覆盖镜像

quotes-db服务包含build字段，需确认其Dockerfile的基础镜像是否为PG 15版本：
打开./QuotesMicroservice/sql/Dockerfile，确保第一行是：

FROM postgres:15.7
# 后续自定义配置

若使用了FROM postgres:latest或其他非15版本，会导致构建出的镜像版本不符，需修改后重新构建：

docker compose build quotes-db
docker compose up -d quotes-db

3. 升级数据目录至PG 16版本（谨慎操作）

若需升级到PG 16，先完成数据备份，再通过pg_upgrade工具迁移数据：

1. 停止目标容器：

docker compose stop activities-db

2. 运行临时容器执行升级：

docker run --rm -v db_activities:/old_data -v ./new_pg_data:/new_data postgres:16.1 bash -c "
apt-get update && apt-get install -y postgresql-15
pg_upgrade \
  --old-datadir=/old_data \
  --new-datadir=/new_data \
  --old-bindir=/usr/lib/postgresql/15/bin \
  --new-bindir=/usr/lib/postgresql/16/bin \
  --user=postgres
"

3. 替换原数据卷内容（需确认备份完成）：

docker run --rm -v db_activities:/data -v ./new_pg_data:/new_data busybox cp -a /new_data/. /data/

4. 修改docker-compose.yml中activities-db的镜像为postgres:16.1，启动容器：

docker compose up -d activities-db

内容的提问来源于stack exchange，提问作者La Bola Al Riel