Qt连接MySql驱动加载失败问题解决(报错:QSqlDatabase: QMYSQL driver not loaded)

错误背景:

qt连接不上数据库。

在使用Qt连接mysql数据库的时候,遇到过这样的报错:

        (1)QSqlDatabase: QMYSQL driver not loaded
   (2)QSqlDatabase: available drivers: QSQLITE QODBC QODBC3 QPSQL QPSQL7

这是qt不能够加载数据库的驱动导致的。

解决办法:

一、检查qt的构建设置和mysql的版本

qt的构建设置和mysql要保持相同位数,如我用的是64位,mysql也要是64位的版本。

*mysql位数可以在mysql的控制台中输入 “show variables like '%version_%';”查看。

二、生成驱动

Qt目录里缺失了和Mysql的连接插件qsqlmysql.dll。

1.检查驱动

先看看自己的Qt目录下有没有连接插件qsqlmysql.dll,我的文件夹位置(参考):

2.编译出qmysql.dll文件

用Qt里的src源码中的mysql源码来编译出qmysql.dll文件。

2.1 没有src文件的(找到这个文件的跳过本小节)

有的大佬安装Qt是没有选择安装src源码,没关系,咱们去下载一个就可以了。

清华镜像:Index of /qt/archive/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

下载qt-everywhere-src-xxx.zip就可以了,解压到你的qt文件夹。

访问5.15版本前的需要梯子,请注意。我下载的版本链接:

download.qt.io/archive/qt/5.14/5.14.2/single/

2.2构建mysql.pro

用Qt creator打开mysql.pro,添加下面的三行代码:

INCLUDEPATH +=E:/DateBase/Mysql/mysql-5.7.29-winx64/include/    # 添加你自己的mysql安装目录下的include文件夹
LIBS += E:/DateBase/Mysql/mysql-5.7.29-winx64/lib/libmysql.lib # 添加你的mysql安装目录下的lib文件夹下的libmysql.lib文件
DESTDIR = ../mysql/mysqlDll    # 设置编译好的qmysql.dll放置的目录,这个是保存生成的dll文件的位置。

*注意:这几个路径不可以有空格,如果有空格可以加双引号或者把路径放进这个$$quote()方法就好了,不用去重新安装数据库改路径。

或者,还有一个偷懒的办法,即像我一样把这两个文件夹复制到qt文件夹下:

我的文件:

代码:

然后进行构建,这时会出现两个错误:
Cannot read H:/qtsqldrivers-config.pri: No such file or directory
Project ERROR: Library 'mysql' is not defined.

别担心,我们一个一个解决

1.我们在上一级文件找到打开qsqldriverbase.pri文件,注释掉第四行:#include($$shadowed($PWD)/qtsqldrivers-config.pri)

加上一句  include(./configure.pir)

(加油,还剩最后一个问题)

2.重新打开mysql.pro,将第六行注释掉,#QMAKE_USE += mysql

注意这个时候需要重新构建,而不是构建!

3.转移驱动

找到之前指定好的dll放置的路径,里面有三个文件

统统拷贝到:D:\code\qt5.14\5.14.2\mingw73_64\plugins\sqldrivers

完成,此时可以连接数据库了!

备注

如果上面的办法还是不能帮你解决问题,再试试这个:

1.把mysql的bin目录添加到环境变量

2.将mysql安装目录下的lib文件夹下的libmysql.dll,复制到qt的编译器的bin目录下。

------------------------------------------------------------------------------------------------------------------------------

本人是qt小白,技术有限。写得不好的地方希望各位大佬指正海涵,衷心希望帮助您解决问题~

### 解决方案 在 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]。 --- ### 总结 以上方法涵盖了从基础排查到高级定制的过程。优先尝试调整插件路径和补充依赖项;若仍失败则考虑重新编译驱动程序。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值