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的，这两个编辑器有什么区别读者自行查阅相关知识
        
        你需要用那种编译器，你安装的时候记得勾选上对应编译器，之后你就用哪个，两个都选上也可以，之后你就会有两个编译器文件夹
        
        我自己两个编译器都有选择：
        
        到QT5.15.2才开始有MSVC2019的编辑器，这里如果某些人考虑以后使用自己的新版vs开发QT程序，用新的msvc2019编辑器肯定是没问题的，如果是2017，您的vs如果太新可能不太支持
        
        mingw编译器就不用说了，想用哪个用哪个
        
        后面编译qmysql文件，两个不同的编译器有点小区别，但必须分开，对照你自己使用的编译器操作🎈🎈🎈
        
        第三：安装方式问题
        
        Qt5.14.2是最后提供二进制安装包的版本，后面的版本都需要在线安装。（我是用的在线安装，在线安装的界面也更帅）
        
        我自己勾选的插件：
        
        在安装QT的时候，记得勾选Source选项，这是QT的源码，我们后面要通过Qt里的src源码中的mysql源码来编译出qmysql.dll文件
        
        第四：安装路径问题
        
        1.Qt编译程序的时候是以空格来解析“编译指令”中的字符串，指定路径中包含空格的时候，会被解析成多个字符串，也就是说，只要保证：编译的时候指定的路径中不包含空格就可以了。🤗🤗🤗
        
        2.路径绝对不能含有中文，包括以后的构建目录都不能含有中文，否则在以后构建运行项目的时候会报编译错误。
        
        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 5.15.2 MinGW 64-bit 编译
        
        一、打开Qt的安装目录下：E:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers\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放置的目录，不然你可能不知道会生成在哪。
        
        注意：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：
        
        打开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.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
        
        添加 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驱动加载失败问题解决方法
        
        行文至此，落笔为终。文末搁笔，思绪驳杂。只道谢不道别。早晚复相逢,且祝诸君平安喜乐，万事顺意。