Laradock中PostgreSQL连接失败求助：postgres角色不存在

问题分析 #

从日志和配置来看，核心问题包括：

• .env文件中POSTGRES_USER配置项的值前存在多余空格，导致环境变量解析异常
• PostgreSQL数据卷已存在，容器启动时跳过初始化流程，新配置未生效
• 执行连接命令时指定的用户与配置不符

解决步骤 #

1. 修正.env配置文件 #

打开Laradock目录下的.env，找到PostgreSQL配置段，移除POSTGRES_USER值前的空格：

### POSTGRES ##############################################

POSTGRES_VERSION=alpine
POSTGRES_CLIENT_VERSION=15
POSTGRES_DB="laravel-10"
POSTGRES_USER=postgres  # 去掉值前面的空格
POSTGRES_PASSWORD=password
POSTGRES_PORT=5433
POSTGRES_ENTRYPOINT_INITDB=./postgres/docker-entrypoint-initdb.d

2. 清理旧PostgreSQL数据卷 #

由于容器已创建过数据卷，初始化流程不会重复执行，需清理旧数据卷让新配置生效：

# 停止相关容器
docker-compose down nginx postgres pgadmin

# 删除PostgreSQL数据卷（注意：此操作会清除现有数据库数据）
docker-compose rm -v postgres

3. 重启容器并验证配置 #

# 重新启动服务
docker-compose up -d nginx postgres pgadmin

# 连接PostgreSQL验证用户和数据库是否创建成功
docker-compose exec postgres psql -U postgres -d laravel-10

执行后若进入PostgreSQL命令行界面，说明配置生效。

4. 配置PGAdmin连接 #

在PGAdmin创建服务器时，使用以下配置：

• 主机名/地址：postgres（直接用Docker服务名，无需IP）
• 端口：5432（容器内部PostgreSQL端口，而非宿主机映射的5433）
• 用户名：postgres（与修正后的.env配置一致）
• 密码：password（与.env配置一致）

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