Qt5中QPSQL驱动未加载问题求助（附代码及环境信息）

核心原因 #

Qt显示可用驱动包含QPSQL但加载失败，本质是Qt自带的QPSQL驱动与PostgreSQL15.2版本不兼容，或者驱动无法找到PostgreSQL的依赖库。

分步解决办法 #

1. 配置PostgreSQL库路径 #

• 找到PostgreSQL 15.2安装目录的bin文件夹（例如C:\Program Files\PostgreSQL\15\bin），将该路径添加到系统环境变量Path中。
• 重启Visual Studio和Qt Creator，确保环境变量生效。

2. 手动复制依赖库到程序目录 #

直接复制PostgreSQL的核心依赖库到你的程序输出目录（debug或release文件夹）：

• libpq.dll（PostgreSQL安装目录bin下）
• libcrypto-3-x64.dll、libssl-3-x64.dll（若PostgreSQL的bin目录存在这两个文件，一并复制）

3. 重新编译适配版本的QPSQL驱动（关键） #

Qt5.8自带的QPSQL驱动不兼容PostgreSQL15.2，需自行编译：

1. 打开Qt的MSVC2015 64位命令提示符（开始菜单→Qt 5.8.0→Qt 5.8.0 for Desktop (MSVC 2015 64-bit)）
2. 进入Qt源码的PSQL驱动目录，路径示例：Qt安装目录\5.8\Src\qtbase\src\plugins\sqldrivers\psql
3. 执行qmake命令，指定PostgreSQL的头文件和库路径：

   qmake "INCLUDEPATH+=C:\Program Files\PostgreSQL\15\include" "LIBS+=C:\Program Files\PostgreSQL\15\lib\libpq.lib" psql.pro
   

4. 编译并安装驱动：

   nmake
   nmake install
   

5. 编译完成后，将生成的qsqlpsql.dll（release版）和qsqlpsqld.dll（debug版），替换Qt安装目录\5.8\msvc2015_64\plugins\sqldrivers下的原有文件。

4. 优化代码初始化逻辑 #

你的代码可以简化，同时补充必要的数据库连接参数，避免潜在问题：

#include <QtSql>
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    
    QSqlDatabase testdb = QSqlDatabase::addDatabase("QPSQL", "mydatabase");
    testdb.setHostName("localhost");
    testdb.setDatabaseName("your_db_name");
    testdb.setUserName("postgres");
    testdb.setPassword("your_password");
    
    if (!testdb.open()) {
        qDebug() << testdb.lastError().text();
    } else {
        qDebug() << "Database connected successfully";
    }
    
    return a.exec();
}

5. 排查驱动加载细节 #

在代码开头添加以下代码，输出详细的驱动加载信息：

qDebug() << "Available drivers:" << QSqlDatabase::drivers();
QCoreApplication::addLibraryPath("./plugins"); // 可选，指定插件路径
QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL");
qDebug() << "Driver valid:" << db.isValid();
qDebug() << "Load error:" << db.lastError().text();

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