Ubuntu20 LTS+PostgreSQL14环境下pgAdmin4使用postgres用户登录失败问题
2026-9-26
pgAdmin4登录报错解决方案
核心原因
你遇到的报错是pgAdmin4自身管理账号的验证失败，和PostgreSQL数据库的用户配置无关：
pgAdmin4是独立的数据库管理工具，自带一套独立的用户体系，登录页要求输入的是pgAdmin4的管理员账号（必须为邮箱格式），而非PostgreSQL的数据库用户名。你之前配置的pg_hba.conf完全正常，psql能正常登录就证明数据库侧配置没有问题。
操作步骤
1. 重置pgAdmin4管理员账号
你使用的是Ubuntu Server 20 LTS，默认安装的是web版pgAdmin4，直接执行官方重置脚本即可：
sudo /usr/pgadmin4/bin/pgadmin4-setup
执行过程中按照提示输入邮箱格式的管理员用户名（例如pgadmin@local.com）、两次自定义登录密码，完成后重启pgAdmin4服务：
sudo systemctl restart pgadmin4
如果安装的是桌面版pgAdmin4，直接删除本地配置文件即可重置引导流程：
rm -rf ~/.pgadmin/pgadmin4.db
重启pgAdmin4后会自动引导你设置主密码和管理员账号。
2. 登录pgAdmin4并添加数据库连接
使用刚才设置的邮箱格式账号和密码登录pgAdmin4，之后按照以下步骤添加你的PostgreSQL14实例：
- 左侧导航栏右键「服务器」→ 「注册」→ 「服务器」
- 「常规」标签页自定义填写服务器名称，例如
本地PG14 - 「连接」标签页填写以下参数：
- 主机地址：
127.0.0.1 - 端口：
5432 - 维护数据库：
postgres - 用户名：
postgres - 密码：你之前设置的PostgreSQL的postgres用户登录密码
- 可勾选「保存密码」
- 主机地址：
- 点击「保存」即可完成数据库连接。
内容的提问来源于stack exchange，提问作者Nima Masalegooha
相关产品推荐
相关产品推荐
