基于同一Postgres镜像启动第二个容器时密码验证失败问题

云原生阿岚

2026-6-12

问题分析与解决方案

1. 第二个容器验证失败的原因

核心问题是第二个容器启动时，挂载的Postgres数据目录已存在非空数据，导致Postgres跳过了初始化流程（包括读取POSTGRES_PASSWORD环境变量、执行init.sql）。此时容器使用的是数据目录中已有的用户密码（与你指定的YourStrongPassword不一致），因此验证失败。

这种情况通常发生在：

之前启动过相关容器，删除容器时未同步删除关联的数据卷；
误将第一个容器的数据卷挂载到了第二个容器上。

2. Docker是否自动复用卷并跳过init.sql？

Docker不会主动复用卷，但Postgres官方镜像的初始化逻辑仅在数据目录为空时触发：

不指定自定义卷启动容器时，Docker会自动创建匿名卷并挂载到/var/lib/postgresql/data；
使用docker rm <容器名>删除容器时，默认不会删除关联的匿名卷；
若后续启动新容器时复用了这个已存在的非空卷，Postgres会直接使用已有数据，跳过初始化脚本和环境变量配置。

3. 多隔离Postgres容器的最佳实践

显式指定自定义命名卷：每个容器使用独立卷，避免匿名卷的复用问题，同时方便管理：

# 第一个容器
docker run -dp 5432:5432 --name pg-test-dump -v pg-data-1:/var/lib/postgresql/data my-pg-with-dump
# 第二个容器
docker run -dp 5433:5432 --name pg-test-dump1 -v pg-data-2:/var/lib/postgresql/data my-pg-with-dump

删除容器时同步清理卷：如果不再需要容器数据，删除时使用docker rm -v <容器名>，彻底清除关联卷；
避免init.sql重复配置用户密码：依赖Postgres官方镜像的环境变量（POSTGRES_USER/POSTGRES_PASSWORD）创建初始用户，init.sql仅负责业务表和数据初始化，避免冲突；

用Docker Compose管理多容器：通过配置文件统一管理容器、卷、端口，更清晰易维护：

version: '3.8'
services:
  pg1:
    image: my-pg-with-dump
    ports:
      - "5432:5432"
    volumes:
      - pg-data-1:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: YourStrongPassword
      POSTGRES_DB: mydb
  pg2:
    image: my-pg-with-dump
    ports:
      - "5433:5432"
    volumes:
      - pg-data-2:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: YourStrongPassword
      POSTGRES_DB: mydb
volumes:
  pg-data-1:
  pg-data-2:

验证容器初始化状态：通过docker logs <容器名>查看启动日志，确认是否执行了/docker-entrypoint-initdb.d/中的脚本，以及Postgres是否正常初始化。

快速修复当前问题

停止并彻底删除第二个容器及关联卷：

docker stop pg-test-dump1 && docker rm -v pg-test-dump1

重新启动第二个容器并指定新的命名卷：

docker run -dp 5433:5432 --name pg-test-dump1 -v pg-data-2:/var/lib/postgresql/data my-pg-with-dump

查看日志确认初始化完成：
```
docker logs pg-test-dump1
```
日志中出现database system is ready to accept connections即表示初始化完成，此时再用DBeaver连接即可。

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