Ubuntu 21.04安装PostgreSQL后执行psql提示连接服务器失败问题

问题根因 #

你卸载旧版本PostgreSQL时使用的apt remove命令仅会删除程序二进制文件，不会清除已创建的集群配置、数据目录内容。残留的PostgreSQL 13集群占用了默认的5432端口，但因为二进制文件已被删除无法启动；新安装的PostgreSQL 14集群自动被分配到5433端口运行，而psql命令默认会尝试连接5432端口，因此触发连接失败报错。

解决方案 #

方案1：清理残留集群，恢复默认端口配置（无需保留PostgreSQL 13历史数据） #

• 删除状态异常的PostgreSQL 13无效集群：

sudo pg_dropcluster 13 main --stop

• 编辑PostgreSQL 14的配置文件，将端口修改为默认的5432：

sudo nano /etc/postgresql/14/main/postgresql.conf

找到配置项port = 5433，将其修改为port = 5432，保存后退出编辑器。

• 重启PostgreSQL 14集群让配置生效：

sudo systemctl restart postgresql@14-main.service

完成上述操作后直接执行psql即可正常连接数据库。

方案2：临时指定端口连接（无需修改配置） #

如果不需要使用默认端口连接，每次执行psql时指定运行中的PostgreSQL 14的端口即可：

psql -p 5433

补充说明 #

后续如果需要彻底卸载PostgreSQL所有相关内容，建议使用apt purge命令代替apt remove，该命令会同时删除程序对应的配置文件，避免残留信息影响后续安装。

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