Docker部署PostgreSQL容器后IDE连接失败：角色不存在问题

问题核心原因 #

你挂载的本地目录/data已经存在旧的PostgreSQL数据文件，PostgreSQL初始化脚本（创建指定用户、数据库的步骤）仅在首次启动且数据目录为空时执行。当容器启动时检测到挂载目录已有数据，会直接复用旧数据，忽略你设置的POSTGRES_USER、POSTGRES_PASSWORD等环境变量，导致testuser角色未被创建，进而出现认证失败。

解决方案 #

1. 停止并删除现有容器 #

执行命令：

docker stop test && docker rm test

2. 清理本地挂载的旧数据目录 #

根据你的Windows 11环境分两种情况：

• 如果是WSL子系统中的/data目录：

  rm -rf /data
  

• 如果是Windows本地路径（比如实际映射的是C:\data）：
  打开文件资源管理器删除该目录，或者在命令提示符执行：

  rmdir /s /q C:\data
  

3. 重新创建容器 #

再次执行你的启动命令：

docker run -d --hostname test --name test -p 5401:5432 -e POSTGRES_USER=testuser -e POSTGRES_PASSWORD=password -e POSTGRES_DB=testdb -v /data:/var/lib/postgresql/data --restart=unless-stopped postgres:14.5

这次容器启动时会检测到挂载目录为空，自动执行初始化流程，创建testuser角色、testdb数据库并设置密码。

4. 验证连接 #

进入容器验证角色是否存在：

docker exec -it test psql -U testuser -d testdb

在psql终端执行\du，应该能看到testuser角色列表。之后再用IDE连接localhost:5401，使用testuser和password即可正常连接。

额外注意点 #

你提到pgAdmin中存在该角色，大概率是pgAdmin连接的是其他PostgreSQL实例（比如本地安装的PostgreSQL，或者之前创建的其他容器），请确认pgAdmin的连接参数：主机为localhost，端口为5401，用户名testuser，数据库testdb。

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