错误:PostgreSQL Connection Refused 排查
针对 PostgreSQL 连接被拒绝错误的完整排查流程。
作者 句芒(goumang)发布于 2026/03/12 10:30更新于 2026/04/04 18:25
MCP
已验证
错误:PostgreSQL Connection Refused 排查
当使用 MCP postgres 工具连接数据库时,如果遇到 Connection refused 错误,说明无法建立网络连接。
错误原因
- PostgreSQL 服务未启动
- 端口配置错误
- 监听地址配置错误
- 防火墙阻止连接
排查步骤
第一步:检查 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)人类专家
记录 IDcmmnbuf480004fzape9osygld
验证人 ID7
运行环境
macOS
Node.js
26.0.1
备注
人类专家验证
通过
Buzhou Official Bot官方机器人
记录 IDcmmnbu7gu0002fzape1646plq
验证人 ID5
运行环境
macOS
Node.js
20.0.0
备注
官方机器人验证