QT连接MySql数据库失败,编译驱动问题,最详细解决办法
作者:mmseoamin日期:2023-12-14

QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第1张

各位读者你们好🔥


此篇是本专栏的第一篇,本专栏专门收录在学习过程中遇到的环境配置、软件问题等开发环境方面的问题。🚀🚀🚀


刚刚转阴就迫不及待的赶紧写一篇博客来解决一直落下的一个问题:

关于QT和MySql数据库的连接问题😷(在本人经过整整三天的无限踩坑之下,下载又卸载,下载又卸载得出的最完整的解决办法)


文章目录

  • 问题原因
  • 解决问题前
    • QT的安装注意
    • QT版本选择参考文章
    • MySql的安装注意
    • MySql版本选择参考文章
    • 注意
    • 解决问题
      • 使用Qt 5.15.2 MinGW 64-bit 编译
      • 使用Qt 5.15.2MSVC2019 64-bit 编译
      • 其它个例问题:
        • 解决QSqlDatabase:QMYSQL driver not loaded
          • 1.错误提示:
          • 2.解决方法:

            问题原因

            同时安装了Qt和MySQL,但是却访问不了MySQL总体分为以下2个原因:

            ①无QMYSQL驱动

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

            QSqlDatabase: QMYSQL driver not loaded

            QSqlDatabase: available drivers: QSQLITE QODBC QODBC3

            ②有QMYSQL驱动但仍然不能访问

            Qt目录里和Mysql的连接插件qsqlmysql.dll已经老旧。

            QSqlDatabase: QMYSQL driver not loaded

            QSqlDatabase: available drivers: QSQLITEQMYSQL QMYSQL3QODBC QODBC3

            其实2个原因的解决方案是一样的,根本原因是:QMYSQL驱动加载失败

            那么,这里就有一个问题:没有QMYSQL驱动的情况加载失败可以理解,为什么有QMYSQL驱动也会加载失败?

            答案:因为Qt和MySQL是来自不同企业的产品,由于MySQL版本的修改和更新,Qt官方默认提供的QMYSQL驱动已经过旧,无法适用新版本的MySQL,也可能是安装的Qt版本过新,MySQL版本过旧的情况,但通常软件都是向下兼容的,因此前者的可能性要更高一些。但是不管是前者还是后者,原因是一样的:QMYSQL驱动和当前的MySQL版本不匹配。


            怎么解决这个问题呢?MySQL的版本修改和更新会同时更新相应的“库文件”,

            我们只需要拿当前安装的MySQL中的这个“库文件”来重新编译生成一下QMYSQL驱动文件,就可以正常访问MySQL了。


            解决问题前

            QT的安装注意

            个人推荐版本:QT5.15.2

            第一:驱动问题


            现在qt6的版本基本不提供mysql的驱动,而且也没有pro项目让你生成驱动的dll文件,

            想要生成驱动文件,官方的方法是在cmake中生成,过程过于复杂,反正我没有成功。

            待会需要介绍的方法:主要重点在于不要下载qt6的版本因为它没有pro项目让你生成驱动的dll文件,我们的教程也就进行不下去了

            第二:编译器问题


            QT编辑器主要就有msvc的和mingw的,这两个编辑器有什么区别读者自行查阅相关知识

            你需要用那种编译器,你安装的时候记得勾选上对应编译器,之后你就用哪个,两个都选上也可以,之后你就会有两个编译器文件夹

            我自己两个编译器都有选择:

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第2张

            到QT5.15.2才开始有MSVC2019的编辑器,这里如果某些人考虑以后使用自己的新版vs开发QT程序,用新的msvc2019编辑器肯定是没问题的,如果是2017,您的vs如果太新可能不太支持

            mingw编译器就不用说了,想用哪个用哪个

            后面编译qmysql文件,两个不同的编译器有点小区别,但必须分开,对照你自己使用的编译器操作🎈🎈🎈

            第三:安装方式问题


            Qt5.14.2是最后提供二进制安装包的版本,后面的版本都需要在线安装。(我是用的在线安装,在线安装的界面也更帅)

            我自己勾选的插件:

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第3张

            在安装QT的时候,记得勾选Source选项,这是QT的源码,我们后面要通过Qt里的src源码中的mysql源码来编译出qmysql.dll文件

            第四:安装路径问题


            1.Qt编译程序的时候是以空格来解析“编译指令”中的字符串,指定路径中包含空格的时候,会被解析成多个字符串,也就是说,只要保证:编译的时候指定的路径中不包含空格就可以了。🤗🤗🤗

            2.路径绝对不能含有中文,包括以后的构建目录都不能含有中文,否则在以后构建运行项目的时候会报编译错误。

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第4张

            QT版本选择参考文章

            【QT-版本】QT版本选择问题_甲壳剑齿鸟的博客-CSDN博客_qt版本

            具体的QT安装步骤,搜索你想要的qt版本对应下载教程,不过本质上都是一样的,选择你需要的就好🎄🎄🎄

            MySql的安装注意

            之前说过:MySQL的版本修改和更新会同时更新相应的“库文件”,QT官方是对照着MySql来提供的QMYSQL默认驱动,所以,MySQL是老大,QT跟着MySQL走,MySQL版本下载任意一版本就好,反正基本上驱动软件都是对不上的,都需要自己配置一遍😂😂

            MySql版本选择参考文章

            我TM究竟应该选哪个版本的MySQL?!_数据库架构师的博客-CSDN博客_mysql 大数据 哪个版本

            具体的MySql安装步骤,😪😪😪一样自行对应版本搜索教程

            注意

            首先,需要确定一件至关重要的事:检查Qt和MySQL的位数,如果不一致,请卸载其中一个重新安装位数一致的版本。推荐都安装64位的,毕竟新的对以后做点什么事更加方便

            只有Qt和MySQL的位数一样,才能重新编译QMYSQL驱动。

            我的搭配是QT5.15.2+MySql8.0.31,都是win64位的


            解决问题

            首先可以先看看自己的Qt目录下有没有连接插件qsqlmysql.dll,文件夹位置: E:\Qt\5.15.2\msvc2019_64\plugins\sqldrivers

            (注意:这里我是基于msvc编译器的操作,如果是mingw则:E:\Qt\5.15.2\mingw81_64\plugins\sqldrivers)


            如果没有那我们就可以开始之前说的通过Qt里的src源码中的mysql源码来编译出qmysql.dll文件。有多半也是个旧的,不匹配,可以去找个数据库测试连接代码试一试😂😂😂


            这里分为Mingw64-bit的和MSVC201964-bit两种编译器,区别不大,请读者自行替代重复部分😛😛😛

            请选择好自己对应的编译器后再查看对应的方法进行编译哦~

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第5张

            使用Qt 5.15.2 MinGW 64-bit 编译

            一、打开Qt的安装目录下:E:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers\mysql双击打开 .pro 文件

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第6张

            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放置的目录,不然你可能不知道会生成在哪。

            注意:1.一定要用双引号引住MySql头文件和库文件这两个路径,不然后面会出现无法识别到mysql.h的错误

            二、进行构建,就是界面左下角的锤子,这时会出现如下的两个错误:

            (1)Cannot read H:/qtsqldrivers-config.pri: No such file or directory


            出现此问题是因为没有这样的文件,但是可以在目录E:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers下找到configure.pri这个文件,那么我们就把原来需要qtsqldrivers-config.pri的地方注释掉,改成configure.pri:


            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第7张

            打开qsqldriverbase.pri文件,将第四行注释掉,即#include($ s h a d o w e d ( shadowed( shadowed( $PWD)/qtsqldrivers-config.pri),然后添加include(./configure.pri),保存,完成。

            (2)Project ERROR: Library ‘mysql’ is not defined.

            这个问题其实我们已经解决。

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第8张

            在qt左侧栏中双击打开mysql.pro,将第六行注释掉,这样:#QMAKE_USE += mysql。

            😆😆😆重新构建:已经没有看见报错了😆😆😆

            三、构建好后会在我们之前设置好的目录位置DESTDIR = ../mysql/mysqlDll放置我们编译好后生成的文件夹mysqlDll

            使用Qt 5.15.2 MinGW 64-bit构建,则该目录下(E:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers\mysql\mysqlDll)会生成

            qsqlmysql.dll libqslmysql.a qsqlmysql.dll.debug三个文件

            将生成的这三个文件复制到 Qt对应的编译器的安装目录下 E:\Qt.15.2\mingw81_64\plugins\sqldrivers

            在mysql安装目录的lib目录中,找到libmysql.dll,拷贝到对应QT编译器的D:\Qt5.15.2.15.2\mingw81_64\bin目录下


            至此,MinGW 的 MYSQL数据库安装成功🎈🎈🎈

            使用Qt 5.15.2MSVC2019 64-bit 编译

            先将MinGW编译时 在E盘下生成的 mysqlDll 文件夹删掉

            一、打开 msvc-version.conf

            用VScode或者VS都可以, 路径 E:\Qt\5.15.2\msvc2019_64\mkspecs\common

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第9张

            添加 QMAKE_MSC_VER=1900 到首行 点击保存即可

            二、 重新打开 D:\Qt5.15.2\5.15.2\Src\qtbase\src\plugins\sqldrivers\mysql 路径下的 .pro 文件

            点击重新构建(这里构建的基础记得改为msvc编译器)

            在E盘下会重新生成 mysqlDll 文件夹,其中会生成qsqlmysql.dll、qsqlmysqld.dll两个文件

            将生成的这两个文件复制到 Qt对应的编译器的安装目录下 E:\Qt.15.2\msvc2019_64\plugins\sqldrivers

            在mysql安装目录的lib目录中,找到libmysql.dll,拷贝到对应QT编译器的E:\Qt.15.2\msvc2019_64\bin目录下


            至此,MSVC2019 的 MYSQL数据库安装成功🎉🎉🎉

            其它个例问题:

            解决QSqlDatabase:QMYSQL driver not loaded

            1.错误提示:

            QSqlDatabase:QMYSQL driver not loaded

            QSqlDatabase:available drivers: QSQLITE QMARIADB QMYSQL QMYSQL3 QODBC QODBC3

            QPSQL QPSQL7

            2.解决方法:

            将MySQL安装的目录下的bin路径添加到系统的环境变量。 (如何添加环境变量请自行查阅)


            最近的期末程序设计需要用到QT和MySql,花了我三天的时间,也踩了不少的坑。特地写下此教程给有需要帮助的人,如果有错误的地方尽请提出来。

            如果参考资料的博主看到有侵权行为,请联系我,我将删除。🧢🧢🧢

            附上参考文章:

            QT5.15.2连接到MySQL 8.0.25

            Qt连接MySql驱动加载失败问题解决方法


            行文至此,落笔为终。文末搁笔,思绪驳杂。只道谢不道别。早晚复相逢,且祝诸君平安喜乐,万事顺意。

            QT连接MySql数据库失败,编译驱动问题,最详细解决办法,在这里插入图片描述,第10张