无法连接Docker部署的PostgreSQL镜像，提示角色/数据库不存在问题咨询

问题诱因 #

1. 首次初始化失败的残留影响：PostgreSQL官方Docker镜像仅会在挂载的数据卷为空时执行初始化逻辑（创建指定用户、数据库）。首次启动时使用带横杠的非法数据库名stripe-example，导致初始化流程中途中断，不仅指定数据库未创建，postgres用户也未生成。若后续删除数据卷操作未完全生效，或新容器复用了残留数据，初始化逻辑会直接跳过，始终无法生成正确的用户和数据库。
2. 端口冲突导致连接实例错误：如果本地环境原生安装过PostgreSQL服务，会默认占用5432端口，Docker启动时的端口映射可能静默失效，此时本地psql命令连接的是本地原生PostgreSQL实例，而非Docker内启动的实例，自然会提示角色、数据库不存在。

解决方法 #

步骤1：彻底清理旧容器和残留数据卷 #

先停止删除所有相关PostgreSQL容器，再强制删除pgdata数据卷，确保无残留：

# 停止并删除所有postgres镜像启动的容器
docker rm -f $(docker ps -aq --filter ancestor=postgres)
# 强制删除pgdata数据卷
docker volume rm -f pgdata

步骤2：确认5432端口未被占用 #

执行命令查看端口占用，终止占用5432端口的本地PostgreSQL进程，或者修改Docker端口映射避免冲突：

# Linux/macOS 查看5432端口占用
lsof -i:5432
# Windows 查看5432端口占用
netstat -ano | findstr "5432"

如果不想关闭本地PostgreSQL服务，可以将Docker端口映射改为-p 5433:5432，后续连接时指定5433端口即可。

步骤3：重新启动PostgreSQL容器 #

使用合法的下划线格式数据库名启动容器：

docker run -p 5432:5432 -d \
-e POSTGRES_PASSWORD=postgres \
-e POSTGRES_USER=postgres \
-e POSTGRES_DB=stripe_example \
-v pgdata:/var/lib/postgresql/data \
postgres

步骤4：验证连接 #

等待3-5秒待容器初始化完成后再执行连接命令，若修改了端口映射需加上-p参数指定端口：

# 默认5432端口连接
psql stripe_example -h localhost -U postgres
# 改用5433端口的连接命令
psql stripe_example -h localhost -U postgres -p 5433

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