QGIS连接PostGIS失败?常见报错怎么修?

“连不上数据库”不是玄学，是这几个开关没打开

上周一个研究生私信我：“Dr. Gis，我QGIS死活连不上PostGIS，报错信息像天书，项目卡在数据入库这一步，快崩溃了！”——别慌，这种“连接失败综合症”，我在国土空间规划项目里遇到不下二十次。今天咱们就抽丝剥茧，把那些高频报错逐个击破。

第一步：确认你的PostgreSQL服务真的在呼吸

很多人一上来就怪QGIS，其实问题出在“后院起火”——PostgreSQL根本没启动。就像你家WiFi突然断了，第一反应不该是重启手机，而是看路由器灯亮没亮。

实战检查法：

• Windows用户：打开“服务”（services.msc），找到“postgresql-x64-xx”（xx是版本号），状态必须是“正在运行”。
• Mac/Linux用户：终端输入 sudo systemctl status postgresql，看到绿色“active (running)”才算过关。

我在某智慧城市项目部署时，曾因服务器意外断电导致PostgreSQL服务未自启，团队三人折腾半天才发现是服务没跑——重启服务后秒连成功。

第二步：防火墙和端口，别让数据在门口被拦下

PostgreSQL默认用5432端口通信。如果防火墙把它挡了，QGIS再努力也敲不开门。这就好比快递小哥到了你小区，却被保安拦住不让进——你订单状态当然显示“派送失败”。

解决方案：

1. 临时测试：关闭防火墙（仅限调试！生产环境慎用）。
2. 永久方案：在防火墙规则中放行TCP 5432端口。
3. 云服务器用户：记得去控制台安全组添加入站规则，允许5432端口。

# Linux临时开放端口示例
sudo ufw allow 5432/tcp

第三步：pg_hba.conf——数据库的“访客登记簿”

这是最隐蔽也最容易忽略的一环。PostgreSQL有个叫pg_hba.conf的配置文件，专门管“谁能在哪用什么方式访问哪个库”。如果你没在上面“登记”，哪怕密码对，也会被拒之门外。

典型报错： “FATAL: no pg_hba.conf entry for host...”

修改步骤（以本地连接为例）：

1. 找到文件位置（通常在/etc/postgresql/[版本]/main/pg_hba.conf 或安装目录下data文件夹）。
2. 在文件末尾添加一行：host all all 127.0.0.1/32 md5（允许本机所有用户密码登录）。
3. 保存后，重启PostgreSQL服务生效。

第四步：用户名、密码、数据库名——三件套一个都不能错

QGIS连接界面那几个输入框，看似简单，实则暗藏玄机：

• Host：本地填localhost或127.0.0.1；远程填服务器公网IP。
• Port：默认5432，除非你改过。
• Database：你要连的具体数据库名，不是“postgres”那个默认库（除非你真在用它存数据）。
• Username/Password：必须是该数据库的合法用户。注意大小写！

一个小技巧：先用psql命令行或PgAdmin工具测试能否登录。如果命令行都登不上，QGIS肯定也不行——先把基础权限搞定。

终极心法：善用日志，报错信息是藏宝图

当QGIS弹出红色报错框时，别急着关掉。那些英文句子不是诅咒，而是线索。比如：

• “Connection refused” → 服务没开或端口不通。
• “Password authentication failed” → 密码错误或认证方式不对。
• “Database does not exist” → 数据库名拼错或未创建。

养成习惯：复制报错全文去搜索引擎，加上“PostgreSQL”关键词，90%的问题都有现成答案。

总结：连接失败排查四步走

1. 查服务是否运行 → 看灯亮没亮。
2. 查端口是否开放 → 给快递小哥开门。
3. 查pg_hba.conf → 登记访客身份。
4. 查连接参数 → 核对三件套。

数据库连接就像谈恋爱，讲究的是“双向奔赴”。QGIS主动示好，PostgreSQL也得愿意开门。按这个逻辑一步步来，没有连不上的库。

你在连接PostGIS时踩过哪些坑？评论区留下你的报错信息，我来帮你诊断！