Docker部署PostgreSQL12，TablePlus连接提示角色root不存在如何解决？

以下是排查和解决的具体步骤：

1. 确认你连接的是Docker容器内的PostgreSQL实例 #

• 运行docker ps查看容器的端口映射信息，比如输出中的0.0.0.0:5432->5432/tcp表示容器5432端口映射到本地5432。如果本地有其他PostgreSQL服务占用5432端口，TablePlus会默认连到本地实例而非Docker容器。
• 检查本地服务：按下Win+R输入services.msc，找到PostgreSQL相关服务，若处于运行状态，要么停止该服务，要么修改Docker启动命令的端口映射（比如docker run -p 5433:5432 ...），之后TablePlus连接端口改为5433。

2. 验证Docker容器内的root角色状态 #

• 进入容器：docker exec -it <容器ID/名称> bash
• 用root角色登录psql：psql -U root -d <你的数据库名>，如果能正常登录，说明角色存在且密码正确；如果提示密码错误，执行ALTER USER root WITH PASSWORD '你的新密码';设置密码。

3. 修正TablePlus的连接配置 #

• 打开TablePlus的连接设置，确保：
  • 主机：127.0.0.1
  • 端口：与Docker映射的端口一致（比如5432或5433）
  • 用户：root（确认容器内确实存在该角色）
  • 密码：与容器内root角色的密码匹配
  • 数据库：填写你要连接的数据库名称（留空会默认连接与用户名同名的数据库，若不存在也会触发报错）

4. 排查容器启动时的环境变量 #

• 如果你是通过docker run启动容器，检查是否设置了POSTGRES_USER=root环境变量。如果没有，默认超级用户是postgres，你后来手动创建的root角色需要确保权限和密码配置正确。也可以先尝试用postgres用户连接，确认容器实例本身运行正常。

内容的提问来源于stack exchange，提问作者Md Firoz Mia