Docker Compose无法创建PostgreSQL数据库且连接被拒的问题排查

核心原因：PostgreSQL初始化逻辑与Docker卷复用 #

PostgreSQL镜像的初始化流程（创建指定数据库、用户）仅在首次启动且数据目录为空时执行。你的问题主要来自两个关键点：

1. 命名卷已保留旧数据 #

docker-compose中使用了命名卷new-pgsql-container-data，如果之前启动过该项目，这个卷会被持久化保留，其中可能包含旧的PostgreSQL数据。此时即使修改了环境变量（比如用户从giacomo改为attilio），PostgreSQL检测到数据目录非空，会直接跳过初始化流程，不会创建新的test-docker数据库和attilio用户。

而你单独用Dockerfile启动容器时，使用的是匿名卷（或全新的卷），每次启动都是空数据目录，因此初始化能正常执行。

2. PGDATA路径的潜在冲突 #

你在docker-compose中设置了PGDATA: /var/lib/postgresql/data/pgdata，将数据存储到挂载卷的子目录中。如果之前的卷中已经存在该子目录的旧数据，同样会导致初始化流程被跳过。

解决步骤 #

步骤1：彻底清理旧容器与卷 #

删除现有容器及关联的命名卷，确保下次启动时使用全新的空数据目录：

docker-compose down -v

-v参数会强制删除所有关联的卷，包括new-pgsql-container-data。

步骤2（可选）：简化PGDATA配置 #

如果不需要自定义数据存储路径，可以移除PGDATA环境变量，使用PostgreSQL默认的/var/lib/postgresql/data路径，减少路径冲突的概率：

# 修改docker-compose.yml中的db服务配置
db:
  image: postgres:latest
  container_name: pgsql-test-compose
  volumes:
    - new-pgsql-container-data:/var/lib/postgresql/data
  environment:
    POSTGRES_USER: attilio
    POSTGRES_DB: test-docker
    POSTGRES_PASSWORD: 230483
    # 删除PGDATA这一行配置
  ports:
    - 5433:5432

步骤3：重新启动并验证初始化状态 #

执行启动命令：

docker-compose -f ./docker-compose.yml -p test-container up --build --remove-orphans -d

查看PostgreSQL容器日志，确认初始化成功：

docker logs pgsql-test-compose

日志中出现以下内容则说明初始化完成：

creating database "test-docker"
creating user "attilio"
database system is ready to accept connections

步骤4：修正数据库连接参数 #

使用docker-compose中配置的用户信息连接数据库：

• host: host.docker.internal
• port: 5433
• user: attilio（注意不是之前的giacomo）
• db: test-docker
• password: 230483

额外注意事项 #

• depends_on仅保证容器启动顺序，不保证数据库服务完全就绪。后端应用需要添加等待数据库就绪的逻辑（比如Spring Boot配置spring.datasource.hikari.connection-test-query，或使用wait-for-it脚本），避免后端启动时数据库未就绪导致连接失败。
• 后续修改PostgreSQL环境变量（如用户、数据库名）时，必须清理旧卷才能让初始化重新执行，否则环境变量的修改不会生效。

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