使用连接服务文件通过QtSQL连接PostgreSQL数据库

Qt的QPSQL驱动基于PostgreSQL的C客户端库libpq，因此天然支持通过连接服务文件建立连接，只是官方文档未做明确说明。以下是具体实现方案：

C++ Qt 实现 #

#include <QSqlDatabase>
#include <QSqlError>
#include <QDebug>

// 初始化数据库连接
QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
// 通过databaseName指定服务名
db.setDatabaseName("service=foo");

// 尝试建立连接
if (db.open()) {
    qDebug() << "连接成功";
} else {
    qDebug() << "连接失败：" << db.lastError().text();
}

也可以通过连接选项直接指定服务：

QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
db.setConnectOptions("service=foo");
// 此时databaseName可设为空，驱动会优先使用service参数
db.setDatabaseName("");

if (db.open()) {
    // 连接成功后的操作
}

PyQt5 实现 #

Python写法与C++逻辑完全对应：

from PyQt5.QtSql import QSqlDatabase

# 创建连接对象
db = QSqlDatabase.addDatabase("QPSQL")
# 指定服务名
db.setDatabaseName("service=foo")

# 尝试连接
if db.open():
    print("连接成功")
else:
    print(f"连接失败：{db.lastError().text()}")

或者通过连接选项设置：

db = QSqlDatabase.addDatabase("QPSQL")
db.setConnectOptions("service=foo")
db.setDatabaseName("")

if db.open():
    # 后续数据库操作

注意事项 #

• 确保系统中pg_service.conf（PostgreSQL连接服务文件）配置正确，且QPSQL驱动能遵循libpq的规则找到该文件（优先用户目录，其次系统目录）。
• 若需要额外连接参数（如超时设置），可通过setConnectOptions添加，例如setConnectOptions("service=foo;connect_timeout=10")。

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