Qt 操作数据库报错:QSqlDatabase: QSQLITE driver not loaded

本文解决Clion+Qt环境下运行程序出现QSqlDatabase:QSQLITEdrivernotloaded错误的问题。通过将sqldrivers文件夹放置于可执行文件同一目录下,确保程序能够正确加载SQLite动态链接库。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在解决了Clion + Qt的数据库问题后《Clion + Qt 添加SQLite数据库》,又遇到了新的问题,在运行程序时,出现QSqlDatabase: QSQLITE driver not loaded错误

使用下面语句输出支持的数据库,会输出空

qDebug() << "sql drivers" << QSqlDatabase::drivers();

最后发现,在添加了Sql模块后,是不够的,还需要将相关动态链接库拷贝到应用程序运行路径下。

解决方案

首先,去Qt的安装路径下,进入plugins文件夹
我的Qt plugins路径

E:\Qt\Qt5.14.2\5.14.2\mingw73_64\plugins

找到sqldrivers文件夹,直接把这个文件夹拷贝到可执行程序的路径下。不是在工程目录下,(当然,不同环境可能也有差异)比如我这里使用的是Clion编写的Qt程序,路径就是cmake-build-debug
在这里插入图片描述
在这里插入图片描述
再次运行,那条语句就会输出(因为我只保留了qsqlite.dll文件)
在这里插入图片描述

注意

虽然上述已经说过了,但自己也测试过,单独把qsqlite.dll动态库文件拷贝到程序根路径是不行的,必须在sqldrivers文件夹下。
在这里插入图片描述

### 解决方案 在 QT 中遇到 `QMYSQL driver not loaded` 的问题通常是由于 MySQL 驱动未能正确加载引起的。以下是可能导致该问题的原因以及解决方案: #### 1. **MySQL 插件路径配置** QT 安装目录下的插件路径可能未被正确识别,或者缺少必要的动态链接库 (DLL) 文件。确保以下条件满足: - 检查是否存在 `qsqlmysql.dll` 文件于 QT 安装目录中的 `plugins/sqldrivers/` 路径下[^1]。 - 如果上述路径不存在,则需手动构建 MySQL 驱动。 #### 2. **依赖项缺失** MySQL 驱动需要依赖 MySQL Connector/C 库 (`libmysql.dll`) 和其他系统 DLL 文件。如果这些文件丢失或版本不匹配,可能会导致驱动无法加载。 - 下载并安装适合系统的 [MySQL Connector/C](https://dev.mysql.com/downloads/connector/c/)。 - 将 `libmysql.dll` 放置到应用程序的工作目录或系统 PATH 环境变量中。 #### 3. **手动构建 MySQL 驱动** 如果默认的 MySQL 驱动不可用,可以通过源码自行构建: - 打开 QT 安装目录下的 `qtbase/src/plugins/sqldrivers/mysql.pro` 文件。 - 使用命令行工具进入该目录,并执行以下命令以完成构建过程: ```bash qmake "INCLUDEPATH+=C:\path\to\mysql\include" "LIBS+=C:\path\to\mysql\lib\libmysql.lib" nmake ``` 完成后会在 `sqldrivers/release/` 或 `sqldrivers/debug/` 目录生成新的 `qsqlmysql.dll` 文件。 #### 4. **环境变量设置** 确认已将 MySQL 动态链接库所在的路径添加至系统环境变量 `PATH` 中。这一步对于 Windows 平台尤为重要。 #### 5. **验证驱动加载状态** 通过调试代码检查驱动是否成功加载: ```cpp #include <QCoreApplication> #include <QSqlDatabase> #include <QDebug> int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); QStringList drivers = QSqlDatabase::drivers(); qDebug() << "Available SQL Drivers:" << drivers; if (!drivers.contains("QMYSQL")) { qWarning() << "QMYSQL driver is NOT available!"; } else { qDebug() << "QMYSQL driver is successfully loaded."; } return a.exec(); } ``` #### 6. **兼容性问题** 注意 QT 版本与 MySQL 驱动之间的兼容性。当前使用的 QT 6.8.1 可能存在某些特定限制,建议查阅官方文档了解最新支持情况[^4]。 --- ### 总结 以上方法涵盖了从基础排查到高级定制的过程。优先尝试调整插件路径和补充依赖项;若仍失败则考虑重新编译驱动程序。
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值