最近在Windows10中使用Qt5.14.2连接MySQL数据库时碰到一个问题，就是出现QMYSQL driver not loaded的错误，
我使用的系统是Windows10，使用的Qt版本是Qt 5.14.2，Qt Creator版本是4.11.1，安装的MySQL版本是mysql-8.0.16-winx64
在本地MySQL数据库testdb中新建了一张users表，其表结构如下：
随便添加了两条记录如下图所示：
然后使用QtCreator创建一个基于控制台的Qt应用程序,进行数据库的连接，增删改查操作，代码如下：
#include <QCoreApplication>
#include <QSql>
#include <QSqlQueryModel>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>
// 连接数据库
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// 打印Qt支持的数据库驱动
qDebug() << QSqlDatabase::drivers();
QSqlDatabase dbConn;
// 设置QMYSQL驱动，并设置数据库连接信息
dbConn = QSqlDatabase::addDatabase("QMYSQL");
dbConn.setHostName("127.0.0.1");
dbConn.setPort(3306);
dbConn.setDatabaseName("testdb");
dbConn.setUserName("root");
dbConn.setPassword("1030");
bool bConnected = dbConn.open();
if (bConnected)
{
qDebug() << "mysql db connect successful!";
// 对数据库testdb中的users表执行crud操作
// 往users表中添加几条数据
QSqlQuery query(dbConn);
query.prepare("INSERT INTO users(id,email,password,username) VALUES(:id,:email,:password,:username)");
query.bindValue(":id", 3);
query.bindValue(":email", "zhangsan10010@apple.com");
query.bindValue(":password", "123456");
query.bindValue(":username", "zhangsan");
query.exec();
query.prepare("INSERT INTO users(id,email,password,username) VALUES(:id,:email,:password,:username)");
query.bindValue(":id", 4);
query.bindValue(":email", "lisi10010@163.com");
query.bindValue(":password", "lisi123456");
query.bindValue(":username", "lisi");
query.exec();
query.prepare("INSERT INTO users(id,email,password,username) VALUES(:id,:email,:password,:username)");
query.bindValue(":id", 5);
query.bindValue(":email", "wangwu10010@163.com");
query.bindValue(":password", "wangwu123456");
query.bindValue(":username", "wangwu");
query.exec();
// 删除操作 删除 uers 表中id = 5的记录
query.prepare(QString("DELETE FROM users WHERE id=?"));
query.addBindValue(5);
query.exec();
// 更新操作
query.prepare("UPDATE users SET username=?,email=?,password=? WHERE id=?");
query.addBindValue("caolin");
query.addBindValue("caolin@163.com");
query.addBindValue("123");
query.addBindValue(4);
query.exec();
// 查询 遍历
// query.prepare("SELECT id, username, password, email FROM users;");
// query.executedQuery();
query.exec("SELECT id, username, password, email FROM users;");
while(query.next())
{
qDebug() << "id:" << query.value("id").toInt()
<< ",username:" << query.value("username").toString()
<< ",password:" << query.value("password").toString()
<< ",email:" << query.value("email").toString();
}
} else {
qDebug() << "mysql database connect failed!";
}
dbConn.close();
return a.exec();
}
由于使用到Qt中的数据库连接，所以需要在.pro文件中添加QtSql模块的支持：
QT -= gui
# 注意：要添加这一句
QT += sql
CONFIG += c++11 console
CONFIG -= app_bundle
# The following define makes your compiler emit warnings if you use
# any Qt feature that has been marked deprecated (the exact warnings
# depend on your compiler). Please consult the documentation of the
# deprecated API in order to know how to port your code away from it.
DEFINES += QT_DEPRECATED_WARNINGS
# You can also make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
# You can also select to disable deprecated APIs only up to a certain version of Qt.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000 # disables all the APIs deprecated before Qt 6.0.0
SOURCES += \
main.cpp
TRANSLATIONS += \
mysqlExample01_zh_CN.ts
# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target
运行程序
运行程序发现报错：
上网找到一篇总结得还不错的博文：QMYSQL driver not loaded 原理及解决方案
最终按照博主的文章解决了我的问题。
特此转载记录一下：
QMYSQL driver not loaded 原理及解决方案
基本原理
Qt 中有一个典型的 MySql 驱动问题，不出意外的话，只要使用 MySql 数据库，就一定会遇到：
QSqlDatabase: QMYSQL driver not loaded
QSqlDatabase: available drivers: QSQLITE QMYSQL QMYSQL3 QODBC QODBC3 QPSQL QPSQL7
基本原理：Qt 在操作 MySql 时，会尝试加载对应的插件（即：qsqlmysql.dll 和 qsqlmysqld.dll），但由于这些插件依赖于 MySql 的库（即：libmysql.dll），所以当找不到插件或者对应的 MySql 库时，就会加载失败！
为了测试 MySql 数据库连接，我们提供了一个简单的示例程序（配置按需更改）：
#include <QCoreApplication>
#include <QSqlDatabase>
#include <QtDebug>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
db.setHostName("127.0.0.1");
db.setDatabaseName("test");
db.setUserName("root");
db.setPassword("password");
db.setPort(3306);
if (db.open()) {
qDebug() << "Open successfully.";
db.close();
} else {
qDebug() << "Open failed.";
}
return a.exec();
}
下面我们来详细讲解一下，究竟该如何解决上述的 MySql 驱动加载问题？
查找MySQL驱动
在 5.12 及之前的版本中，Qt 的安装包中自带 MySql 驱动，在 plugins/sqldrivers 目录下可以找到：
但到了 5.13 之后，MySql 驱动便没有了，这时我们可以选择手动编译。例如我使用的Qt版本是Qt 5.14.2，在我的Qt安装目录(D:\software\Qt)下的
D:\software\Qt\Qt5.14.2\5.14.2\msvc2017_64\plugins\sqldrivers目录下找不到MYSQL的驱动：Qt 5.14.2中编译MySQL驱动
要编译MySQL驱动，有两个前提条件：
- 在安装 Qt 时，要一并安装源码（勾选“Sources”组件）。
- 需要下载 MySql，编译源码时需要用到。
假设 Qt 源码已经安装了，现在进入 MySql 下载页面（见：https://dev.mysql.com/downloads/mysql/），选择合适的版本进行下载：
mysql 8.0.19
这里我下载的是 mysql 8.0.16，如果要下载其他的版本，可以选择“Archives”。
解压缩下载的安装包，其目录结构如下所示：
这里的“include”和“lib”目录比较重要，它们分别包含了 MySql 的头文件以及相应的库文件，在编译 MySql 驱动时需要用到。
现在进入 Qt 的 MySql 数据库驱动源码目录（例如：D:\software\Qt\Qt5.14.2\5.14.2\Src\qtbase\src\plugins\sqldrivers\mysql），打开 mysql.pro，并进行如下更改：
现在开始使用Qt自带的qmake编译器编译mysql驱动源代码，
由于Oracle官方提供的mysql-8.0.16-winx64的lib库默认是使用微软的msvc编译器编译的64位版本的lib库，所以需要使用D:\software\Qt\Qt5.14.2\5.14.2\msvc2017_64\bin目录下的qmake.exe这个可执行程序，具体路径以你自己的Qt安装目录进行修改。
找到你的MySQL驱动源代码目录，在该目录下，先按住Shift键，鼠标右键单击选择菜单【在此处打开PowerShell窗口】
然后在命令行中键入如下命令：
D:\software\Qt\Qt5.14.2\5.14.2\msvc2017_64\bin\qmake.exe
上网搜了一下，找到了Qt连接MySql驱动加载失败问题解决方法这篇文章，
也就是说需要修改
qsqldriverbase.pri文件，将include($$shadowed($$PWD)/qtsqldrivers-config.pri)这一行注释掉，改成如下的
#include(./configure.pri)
在命令行中使用
qmake重新编译使用QtCreator打开mysql.pro工程文件，生成msvc2017_64的mysql驱动
然后再点击左下角的那个锥子标识进行编译，如下图所示：
可以看到在相应的
D:\software\Qt\Qt5.14.2\5.14.2\Src\qtbase\src\plugins\sqldrivers\mysql\mysqlDll目录下生成了基于msvc2017_64的mysql驱动文件的Debug版本的qsqlmysqld.dll和qsqlmysqld.lib，Release版本的qsqlmysql.dll和qsqlmysql.lib，如下图所示：编译完成后记得将编译后的
qsqlmysql.dll以及qsqlmysqld.dll文件拷贝到相应的目录D:\software\Qt\Qt5.14.2\5.14.2\msvc2017_64\plugins\sqldrivers下
查找依赖
MySql 的库（libmysql.dll）有了，驱动（qsqlmysql.dll 和 qsqlmysqld.dll）也有了，将他们拷贝到程序所在目录，就能正常运行啦？哈哈 O(∩_∩)O，可别高兴的太早哦！
理论上确实如此，但对于高版本的 MySql 来说不行，因为 libmysql.dll 还依赖于其他的库。所以如果按照上述做法，还是会出现“QMYSQL driver not loaded”这样的问题！（很多人被里这坑了，怎么都想不明白）
不信的话，用 Dependencies（见：https://github.com/lucasg/Dependencies）查看一下，是不是有很多依赖的库找不到：
了解之后，现在将这些库文件拷贝到程序所在目录，然后运行程序：
至此，在Windows10中使用Qt 5.14.2连接MySQL数据库成功，并且生成了MSVC2017 64位的qsqlmysqld.dll和qsqlmysql.dll驱动。
