Windows下QGIS连接PostgreSQL提示pg_servicename未找到求助

关键排查步骤 #

1. 配置PGSERVICEFILE环境变量 #

PostgreSQL会优先读取PGSERVICEFILE环境变量指定的文件路径，只要没设置这个变量，系统可能无法定位到你的服务文件：

• 打开Windows「系统属性」→「高级」→「环境变量」
• 新建用户变量（优先）或系统变量，变量名PGSERVICEFILE，变量值为你的.pg_service.conf文件的完整绝对路径（例如C:\Users\你的用户名\AppData\Roaming\postgresql\pg_service.conf）
• 设置完成后重启QGIS，必要时重启电脑确保变量生效

2. 确认文件的正确存放路径 #

Windows下PostgreSQL读取服务文件的优先级为：

1. PGSERVICEFILE变量指定的路径
2. 用户目录下的%APPDATA%\postgresql\pg_service.conf（即C:\Users\<你的用户名>\AppData\Roaming\postgresql，注意是Roaming而非Local）
3. 系统级路径PostgreSQL安装目录\etc\pg_service.conf（例如C:\Program Files\PostgreSQL\15\etc，但需确保当前用户有读取权限）

你之前放置的/AppData/postgresql路径不完整，必须是当前用户的AppData/Roaming目录下的postgresql文件夹。

3. 检查文件名与拼写细节 #

• 确保文件名是.pg_service.conf，注意开头的英文句点（.），Windows默认隐藏文件扩展名，需在文件夹选项中开启「显示文件扩展名」，避免不小心存成pg_service.conf.txt（这是高频错误）
• 服务名pg_servicename要和文件中[pg_servicename]的名称完全一致（大小写尽量统一，避免不必要的兼容问题）

4. 验证文件读取权限 #

右键.pg_service.conf文件→「属性」→「安全」，检查当前登录用户是否拥有读取权限，如果没有，点击「编辑」添加当前用户的读取权限。

5. 用命令行测试服务文件是否生效 #

打开命令提示符（cmd），执行命令：

psql service=pg_servicename

• 如果能成功连接数据库，说明服务文件配置没问题，问题出在QGIS的配置或驱动
• 如果同样报错找不到服务，继续回到前面的步骤排查服务文件的路径、拼写或权限

6. 排查QGIS的PostgreSQL驱动兼容性 #

先尝试用QGIS的「标准连接」（直接输入host、dbname、user等信息）测试能否连接数据库：

• 如果能连接，说明QGIS的PostgreSQL驱动正常，问题仍在服务文件配置
• 如果不能连接，可能是QGIS自带的驱动与你的PostgreSQL版本不兼容，可尝试安装对应版本的PostgreSQL客户端库，并在QGIS中配置使用该库

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