QSQLDatabase报错，如何有效解决？-HCRM博客

在使用Qt进行数据库操作时，开发者可能会遇到各种报错问题，以下是一些常见的QSqlDatabase报错及其解决方法：

1、QSqlDatabase: QSQLITE driver not loaded

（图片来源网络，侵权删除）

错误描述：这个错误通常意味着Qt没有加载SQLite的驱动程序。

解决方案

检查模块添加：确保在项目的.pro文件中添加了sql模块，例如QT += sql。

拷贝动态链接库：将Qt安装路径下的Plugins/sqldrivers/qsqlite.dll文件拷贝到应用程序的运行目录下，注意保持目录结构。

环境变量配置：确保Qt的环境变量设置正确，将MySQL驱动程序所在的路径添加到Qt的库路径中。

2、QSqlDatabase: QMYSQL driver not loaded

（图片来源网络，侵权删除）

错误描述：这个错误通常意味着Qt没有加载MySQL的驱动程序。

解决方案

安装MySQL驱动：确保系统上已经安装了MySQL驱动程序，可以从MySQL官方网站下载适用于操作系统和Qt版本的驱动程序。

拷贝动态链接库：将MySQL驱动程序（如libmysql.dll）拷贝到Qt的插件目录或应用程序的运行目录下。

代码中显式加载：在初始化数据库连接之前，使用以下代码显式加载MySQL驱动程序：

         #include <QtSql>
         QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL", "myConnection");

3、QSqlDatabase: QOCI driver not loaded

（图片来源网络，侵权删除）

错误描述：这个错误通常意味着Qt没有加载Oracle的OCI驱动程序。

解决方案

安装OCI驱动：确保已安装Oracle的OCI驱动程序，并将其路径添加到系统环境变量中。

拷贝动态链接库：将Oracle的OCI驱动文件（如oci.dll）拷贝到Qt的插件目录或应用程序的运行目录下。

4、QSqlDatabasePrivate::database: requested database does not belong to the calling thread

错误描述：这个错误通常意味着数据库连接请求来自非主线程。

解决方案

多线程处理：确保数据库操作在主线程中进行，或者使用适当的线程同步机制来处理数据库连接。

5、QSqlQuery::exec: database not open

错误描述：这个错误通常意味着数据库连接未成功打开。

解决方案

检查连接参数：确保数据库连接参数（如主机名、用户名、密码等）正确无误。

错误信息获取：使用db.lastError().text()获取详细的错误信息，以便进一步排查问题。

6、fatal error C1083: 无法打开包括文件:“QSqlDatabase”: No such file or directory

错误描述：这个错误通常意味着编译器找不到QSqlDatabase头文件。

解决方案

检查项目配置：确保项目配置中包含了sql模块，并且正确设置了包含路径。

清理并重新编译：删除Debug目录后重新编译项目，以确保所有依赖项都被正确包含。

以下是一个简单的示例代码，演示如何在Qt应用程序中建立MySQL数据库连接：

#include <QCoreApplication>
#include <QtSql>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>
#include <QDebug>
int main(int argc, char *argv[]) {
    QCoreApplication app(argc, argv);
    // 添加数据库连接
    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL", "myConnection");
    db.setHostName("localhost"); // 设置数据库服务器地址
    db.setDatabaseName("mydatabase"); // 设置数据库名称
    db.setUserName("myusername"); // 设置数据库用户名
    db.setPassword("mypassword"); // 设置数据库密码
    // 尝试打开数据库连接
    if (!db.open()) {
        QSqlError error = db.lastError(); // 获取错误信息
        QString errorMessage = error.text(); // 获取错误描述文本
        qDebug() << errorMessage; // 输出错误信息到控制台
        return 1;
    }
    // 在这里执行数据库操作...
    return app.exec();
}