Docker部署PostgreSQL未创建.env定义的自定义用户问题

你的配置文件逻辑正确，容器也已加载POSTGRES_USER等环境变量，但PostgreSQL仅生成默认postgres用户，核心原因是：Postgres镜像仅在首次初始化数据卷时执行用户创建逻辑。若db-data卷此前已存在（比如曾用默认配置启动过容器），后续修改环境变量不会触发重新初始化，旧数据卷中的默认用户配置会被保留。

解决步骤 #

• 停止并删除现有容器及关联数据卷
  执行命令彻底清理旧环境：

  docker-compose down -v
  

  -v参数会删除所有服务关联的卷，包括存储PostgreSQL数据的db-data卷。

• 优化.env文件（可选但推荐）
  去掉变量值外的引号，避免潜在解析问题：

  POSTGRES_USER=user123
  POSTGRES_PASSWORD=password456
  POSTGRES_DB=db
  POSTGRES_PORT=5432
  POSTGRES_HOST=localhost
  POSTGRES_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}?schema=public
  

• 重新启动服务

  docker-compose up -d
  

• 验证用户创建结果
  进入容器执行查询：

  docker exec -it api_db_1 psql -U postgres -c "SELECT usename from pg_user;"
  

  或直接用指定用户连接数据库：

  psql -h localhost -U user123 -d db
  

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