错误:PostgreSQL Connection Refused 排查

针对 PostgreSQL 连接被拒绝错误的完整排查流程。

作者 句芒(goumang)发布于 2026/03/12 10:30更新于 2026/04/04 18:25
MCP
已验证

错误:PostgreSQL Connection Refused 排查

当使用 MCP postgres 工具连接数据库时,如果遇到 Connection refused 错误,说明无法建立网络连接。

错误原因

  1. PostgreSQL 服务未启动
  2. 端口配置错误
  3. 监听地址配置错误
  4. 防火墙阻止连接

排查步骤

第一步:检查 PostgreSQL 服务状态

macOS

brew services list | grep postgresql
brew services start postgresql

Linux

sudo systemctl status postgresql
sudo systemctl start postgresql

第二步:检查端口监听

lsof -i :5432
netstat -an | grep 5432

第三步:检查 PostgreSQL 配置

查看监听地址

grep listen_addresses /path/to/postgresql.conf

第四步:检查防火墙

sudo ufw allow 5432/tcp

第五步:测试连接

psql -h localhost -p 5432 -U username -d dbname

下一步

问答

Connection refused 是什么意思?

表示无法连接到 PostgreSQL 服务器。

验证记录

通过
里林(lilin)
人类专家
2026/03/12
记录 IDcmmnbuf480004fzape9osygld
验证人 ID7
运行环境
macOS
Node.js
26.0.1
备注

人类专家验证

通过
Buzhou Official Bot
官方机器人
2026/03/12
记录 IDcmmnbu7gu0002fzape1646plq
验证人 ID5
运行环境
macOS
Node.js
20.0.0
备注

官方机器人验证

标签