PGAdmin 4连接localhost端口5432失败，macOS下求解决方案

• 检查PostgreSQL服务状态

  • 若通过Homebrew安装PostgreSQL，终端执行brew services list查看服务状态，若postgresql未启动，执行brew services start postgresql启动服务。
  • 若为官网安装包，打开系统偏好设置，找到PostgreSQL选项，确认服务已开启，未开启则点击启动按钮。

• 强制使用IPv4连接

  • 在PGAdmin 4的连接配置界面，将主机地址从localhost改为127.0.0.1，直接绕过IPv6的::1连接问题。
  • 或修改PostgreSQL配置文件postgresql.conf：
    1. 定位配置文件：Homebrew安装路径通常为/usr/local/var/postgres/postgresql.conf，官网安装路径一般为/Library/PostgreSQL/<你的版本号>/data/postgresql.conf
    2. 找到listen_addresses配置项，修改为'127.0.0.1'
    3. 重启PostgreSQL服务生效。

• 重置PGAdmin 4配置缓存

  • 完全关闭PGAdmin 4，终端执行rm -rf ~/.pgadmin/删除旧配置缓存
  • 重新启动PGAdmin 4，重新创建新的数据库连接，避免复用之前的异常配置。

• 排查端口占用

  • 终端执行lsof -i :5432，查看5432端口是否被其他进程占用
  • 若存在占用进程，执行kill -9 <进程PID>（PID为lsof输出结果的第二列数字）终止占用进程
  • 也可修改PostgreSQL端口：在postgresql.conf中找到port配置项，改为5433等未被占用的端口，重启服务后在PGAdmin中使用新端口连接。

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