Qt 6.5.2 QPSQL驱动未加载问题求助（Windows环境）

云上老周

2026-7-11

解决Qt 6.5.2 QPSQL驱动未加载问题的排查步骤

检查PostgreSQL依赖库完整性
QPSQL驱动依赖PostgreSQL客户端核心库（如Windows下的libpq.dll、Linux下的libpq.so），仅放置qsqlpsql.dll/libqsqlpsql.so不足以加载驱动：
- 下载与Qt架构（32/64位）、编译器版本（MSVC/GCC）匹配的PostgreSQL客户端运行库
- 将依赖库放到应用程序根目录，或添加到系统PATH环境变量中
验证驱动编译兼容性
官方预编译的Qt驱动可能与你的PostgreSQL版本不兼容，建议自行编译匹配的驱动：
1. 安装PostgreSQL开发包（包含头文件与静态库）
2. 打开Qt对应编译器的命令行工具，进入Qt源码的qtbase/src/plugins/sqldrivers/qpsql目录
3. 执行编译配置命令：
```
qmake "INCLUDEPATH+=/path/to/postgresql/include" "LIBS+=/path/to/postgresql/lib/libpq.lib"
```
4. 执行nmake（MSVC）或make（GCC）完成编译，将生成的驱动文件替换到Qt的plugins/sqldrivers目录
强制指定插件加载路径
在代码中手动设置插件路径，避免Qt自动查找路径出错：

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QDebug>

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);
    // 手动指定sqldrivers插件目录
    QCoreApplication::addLibraryPath(QCoreApplication::applicationDirPath() + "/plugins");
    
    QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
    db.setHostName("远程数据库地址");
    db.setDatabaseName("目标库名");
    db.setUserName("用户名");
    db.setPassword("密码");
    db.setPort(5432);

    if (!db.open()) {
        qDebug() << "Error:" << db.lastError().text();
    } else {
        qDebug() << "数据库连接成功";
    }
    return a.exec();
}

同时可设置环境变量QT_DEBUG_PLUGINS=1运行程序，查看插件加载的详细错误日志，定位具体失败原因。