使用了QSqlDatabase数据库，报错：Driver not loaded

最新推荐文章于 2025-06-19 22:54:31 发布
原创 最新推荐文章于 2025-06-19 22:54:31 发布 · 2.9k 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

在使用Qt的QSqlDatabase连接SQLite数据库时，遇到'Driver not loaded'错误。问题出现在未将必要的Qt库文件和驱动添加到运行路径下。解决方法是将Qt安装目录下的Qt5Sql.dll和sqldrivers文件夹复制到程序运行目录，确保所有依赖项完整。

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

1.环境

（1）已经安装了sqlite；

（2）qt-opensource-windows-x86-msvc2010_opengl-5.4.0.exe；

（3）使用vs2010来开发。


2.现象

若加入如下代码：

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");

         db.setDatabaseName("scooters.dat");

         if (!db.open()) {

                  

最低0.47元/天 解锁文章

200万优质内容无限畅学
报错：QSqlDatabase: QSQLITE driver not loaded...
**My Coding Family**
07-19 1655
ok，以上就是我这期的Bug修复内容啦，如果还想查找更多解决方案，你可以看看我专门收集Bug及提供解决方案的专栏《优快云问答解惑-专业版》，都是实战中碰到的Bug，希望对你有所帮助。到此，咱们下期拜拜。码字不易，如果这篇文章对你有所帮助，帮忙给 bug菌 来个，您的支持就是我坚持写作分享知识点传播技术的最大动力。「猿圈奇妙屋」；
关于qt安装mysql驱动 qt连接数据库报错：QSqlDatabase: QMYSQL driver not loaded
qq_52481983的博客
08-05 677
我在解决这问题时网上搜的解决办法中要添加环境变量，其实并不需要，只是cmd命令行获取版本时需要。首先在qt安装文件夹下，如下图是否有此两个文件若是没有需要通过编译源码或者去github下载。下载完之后将文件夹内的以下两个文件复制到qt安装文件夹对应版本的bin目录下。github链接放在此处，qt6到qt5对应的版本驱动都有。下载完解压之后将这两个文件放入qt对应的文件夹内。下载对应的版本，此文件为mysql的lib文件。到此mysql官网下载对应版本的文件。32位放在32位，64位放在64位。
Qt 操作数据库报错：QSqlDatabase: QSQLITE driver not loaded
热门推荐
L-Super的博客
03-27 1万+
在解决了Clion + Qt的数据库问题后《Clion + Qt 添加SQLite数据库》，又遇到了新的问题，在运行程序时，出现QSqlDatabase: QSQLITE driver not loaded错误 使用下面语句输出支持的数据库，会输出空 qDebug() << "sql drivers" << QSqlDatabase::drivers(); 最后发现，在添加了Sql模块后，是不够的，还需要将相关动态链接库拷贝到应用程序运行路径下。 解决方案 首先，去Qt的安装路径下
QSqlDatabase: QSQLITE driver not loaded
最新发布
优快云_RTKLIB的博客
06-19 917
QSqlDatabase: QSQLITE driver not loaded 错误解决办法
Debug 1：QSqlDatabase: QSQLITE driver not loaded
youzai2017的博客
05-12 1268
Debug 1：QSqlDatabase: QSQLITE driver not loaded 问题：在Qt应用中，我使用qtsqlite来操作本地sqlite数据库，在部署执行时会出现下面问题 QSqlDatabase: QSQLITE driver not loaded QSqlDatabase: available drivers: [14:04:10.382625] [error] [main.cpp_389]: open db fail, db:xxx Driver not loaded 解决
Pyside QSqlDatabase: QSQLITE driver not loaded 错误
11-13 2021
因为在QT中这些数据库驱动 都是以插件的形式加载的，一般出现这个错误是因为驱动没有加载成功，完了解决的办法就是在程序的开头或者调用数据库部分的前面加上两句话。 import site site_pack_path = site.getsitepackages()[1] QApplication.addLibraryPath('{0}\\PySide\\plugins'.format(si
QtCreator5.12+MVCS2017编译器+Oracle12.2数据库报错 QSqlDatabase: QOCI driver not loaded
04-23
本文档中记录了QtCreator5.12下使用MVCS2017_64编译器连接Oracle12.2数据库时遇到的问题及解决方法，如： QSqlDatabase: QOCI driver not loaded，包括驱动的添加，数据库的安装配置，经过亲测通过，每一步都配有...
ubuntu中Qt可执行程序MYSQTL连接报错：QSqlDatabase: QMYSQL driver not loaded QSqlDatabase: available drivers
wuhao
10-24 464
背景：Qt程序进行mysql连接，报错通过编译生成libqsqlmysql.so文件的驱动，可以解决本地的mysql的数据库连接，但是复制可执行程序release到其他ubuntu环境中报错，很明显就是驱动没有加载的，但是可执行程序已经有驱动so文件。少了对应的库，在开发的环境上复制过来，确保每一个库都能找到，同时设置LD_LIBRARY_PATH的环境路径对应起来。重点是解决本地可以安装mysql驱动连接，移植到其linux报错驱动没有加载。
Qt访问Mysql数据库报错：QSqlDatabase: QMYSQL driver not loaded的解决方案
formaever的专栏
09-25 3373
3.构建成功后，在E:\Qt\Qt5.14.2\5.14.2\Src\qtbase-everywhere-src-5.14.2\src\plugins\sqldrivers\mysql\mysqlDll目录有下面三个文件。找到E:\Qt\Qt5.14.2\5.14.2\Src\qtbase-everywhere-src-5.14.2\src\plugins\sqldrivers\mysql路径，用qt打开。从上面的错误提示来看，是qt中没有Mysql的驱动，在qt的安装目录下查找，确实没有mysql驱动。
Qt + Sqlite开发出现错误：QSqlDatabase: QSQLITE driver not loaded
weixin_41085521的博客
08-11 8087
在Qt项目中连接Sqlite数据库： void PhenotypeManagementDialog::connectDb() { QMessageBox msgBox; QSqlDatabase dbconn = QSqlDatabase::addDatabase("QSQLITE"); dbconn.setDatabaseName("D:/work/gooal-cloud/Sqlite_test/score.db"); if (!dbconn.open()) { dbconn.close
Qt linux发布出现QSqlDatabase: QSQLITE driver not loaded问题
老吕丶的博客
11-29 5043
出现这个问题的原因是我们打包的时候并没有打包QSql的库文件，解决办法如下： 1.复制QT安装目录下plugins到当前应用程序的打包目录，只用到sql的话可以把其它的删掉，只留sqldrivers文件夹就可以。我是安装到/opt目录下的，plugins路径为： /opt/Qt5.12.9/5.12.9/gcc_64/plugins 2.设置环境变量QT_PLUGIN_PATH的值为plugins的路径，如 export QT_PLUGIN_PATH=xxxxx/plugins 我们可以把.
【Remi Pi】嵌入式Linux开发板QSqlDatabase：QSQLITE driver not loaded问题
daviddou2022的博客
08-09 968
【Remi Pi】嵌入式Linux开发板QSqlDatabase：QSQLITE driver not loaded问题，使用sqlite.h代替Qsql库
Qt 封装Sqlite类，及问题出现QSqlDatabase: QSQLITE driver not loaded 解决
边城浪子书生的博客
08-28 2079
使用qt 自带的QSql 模块连接Sqlite类，封装简易版本，还可以继续完善。 头文件 ： #pragma once /////////////////////////////////////////////////////////// // DataBase.h // description：Sqlite // Created on: 12-08-2020 21:12:15 // Original author: karlchan /////////////////////////////
解决Qt5.9.5下Release程序报错QSqlDataBase:QSQLite driver not loaded
limelove的博客
10-19 1755
写了一个小程序给同事用，在Debug模式下运行都正常，只要Release运行就报错QSqlDataBase:QSQLite driver not loaded。采用windeployqt打包整个程序后也是报这个错。百思不得其解。 以下是采用windeployqt打包后的目录，sqldrivers（也就是依赖的sql动态库）直接被生成到程序目录下。 上网查找解决方案，给出的回答都是：把依赖的动态库放到程序目录下。 尝试把sqldrivers下的全部动态库直接拷贝到程序目录下，也还是不..
Qt for android Sqlite数据库的QSQLITE驱动程序未加载（QSQLITE driver not loaded）
weixin_43298436的博客
06-01 1314
其中"/data/user/0/org.qtproject.example/qt-reserved-files/plugins"为Android内应用的so库的存放位置。一般情况下plugins/sqldrivers/ 这个位置会存放libplugins_sqldrivers_libqsqlite.so库 只要告诉qt。在某些场合 qt是会不加载SQL的so库的 而qt android 的开发就是把qt打包成so库 由java调用so库。地址".../plugins"就可以了。
QSqlDatabase: QMYSQL driver not loaded QSqlDatabase: available drivers: QSQLITE QMYSQL QMYSQL3 QODBC QODBC3 QPSQL QPSQL7 无法连接到数据库: "Driver not loaded Driver not loaded"
05-06
### 问题分析 `QSqlDatabase: QMYSQL driver not loaded` 是 Qt 开发者在尝试连接 MySQL 数据库时常遇到的一个错误。该错误的核心原因是 Qt 的 SQL 插件未能成功加载 `QMYSQL` 驱动程序，这可能由多种因素引起。 以下是可能导致此问题的原因及其解决方案： --- ### 可能原因及解决方案 #### 1. **缺少必要的动态链接库** 如果系统的环境变量 PATH 中未包含 MySQL 安装目录下的 `libmysql.dll` 或其他必要依赖项，则会导致驱动无法加载。 - 确保将 MySQL 安装路径中的 `libmysql.dll` 添加到系统 PATH 环境变量中[^3]。 - 替代方法是手动将 `libmysql.dll` 复制到 Qt 的 bin 目录下（例如：`D:\Qt\5.12.3\mingw73_64\bin`）[^3]。 #### 2. **MySQL 和 Qt 版本不匹配** 不同版本的 MySQL 库可能与特定版本的 Qt 不兼容。如果使用的 `libmysql.dll` 来自较新版本的 MySQL 而 Qt 支持的是旧版库文件，则可能出现加载失败的情况。 - 下载并替换为与当前 Qt 版本兼容的 `libmysql.dll` 文件。可以从 GitHub 上找到经过验证的老版本库文件[^3]。 - 使用 Qt 提供的源码重新构建适用于目标平台的插件也是一个可行的选择[^4]。 #### 3. **SQL 插件未正确编译或部署** 默认情况下，某些 Qt 安装包可能不会自动包含已编译好的 `qsqlmysql.dll` 插件。因此需要自行编译支持 MySQL 的插件。 - 打开 Qt 源码目录中的 mysql.pro 工程文件，并按照官方文档说明完成配置和编译过程[^4]。 ```bash qmake "INCLUDEPATH+=C:/Program Files/MySQL/MySQL Server X.X/include" \ "LIBS+=C:/Program Files/MySQL/MySQL Server X.X/lib/libmysql.lib" mysql.pro make ``` #### 4. **认证协议冲突** 即使解决了驱动加载问题，在实际建立数据库连接时仍有可能因为服务器端启用了新型加密方式而报错，比如 `Authentication plugin 'caching_sha2_password' cannot be loaded`。 - 修改客户端默认密码算法以适应老式接口；或者更新至最新稳定发行版从而全面支持现代安全机制[^3]。 --- ### 示例代码片段 下面展示了一段用于测试 MySQL 连接功能的小型应用程序示例： ```cpp #include <QCoreApplication> #include <QSqlDatabase> #include <QDebug> int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); if (!db.isValid()) { qDebug() << "Driver is invalid!"; } else { db.setHostName("localhost"); // 设置主机名 db.setDatabaseName("test_db"); // 设定要访问的数据集名称 db.setUserName("root"); // 用户账号 db.setPassword(""); // 对应密码 bool ok = db.open(); if (ok){ qDebug()<<"Connected successfully."; } else{ qDebug()<<db.lastError().text(); } } return a.exec(); } ``` 注意调整上述设置值来适配个人环境中真实的数据库实例详情。 --- ### 总结 综上所述，“QSqlDatabase: QMYSQL driver not loaded”的根本成因主要集中在以下几个方面：缺乏适当版本的支持库、插件本身尚未被创建出来以及潜在的操作系统架构差异等方面。针对这些问题采取相应的措施即可有效消除此类障碍。 ---
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值