Windows10下使用Qt5.14.2连接mysql-8.0.16-winx64数据库报错:QMYSQL driver not loaded 原理及解决方案

最近在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表,其表结构如下:

users表

随便添加了两条记录如下图所示:
users表中的记录

然后使用QtCreator创建一个基于控制台的Qt应用程序,进行数据库的连接,增删改查操作,代码如下:

#include 
#include 
#include 
#include 
#include 
#include 


// 连接数据库
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", "[email protected]");
        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", "[email protected]");
        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", "[email protected]");
        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("[email protected]");
        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

运行程序

选择MSVC2017_64bit-Debug

运行程序发现报错:
QSqlDatabase: QMYSQL driver not loaded

上网找到一篇总结得还不错的博文: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 
#include 
#include 
 
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 目录下可以找到:

查找MySQL驱动

但到了 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的驱动

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”。

解压缩下载的安装包,其目录结构如下所示:


mysql 8.0.16-win64

这里的“include”和“lib”目录比较重要,它们分别包含了 MySql 的头文件以及相应的库文件,在编译 MySql 驱动时需要用到。
现在进入 Qt 的 MySql 数据库驱动源码目录(例如:D:\software\Qt\Qt5.14.2\5.14.2\Src\qtbase\src\plugins\sqldrivers\mysql),打开 mysql.pro,并进行如下更改:


在这里插入图片描述

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窗口】

打开PowerShell窗口

然后在命令行中键入如下命令:

D:\software\Qt\Qt5.14.2\5.14.2\msvc2017_64\bin\qmake.exe

qmake编译mysql驱动源代码

qtsqldrivers-config.pri

configure.pri

上网搜了一下,找到了Qt连接MySql驱动加载失败问题解决方法这篇文章,
Qt连接MySql驱动加载失败问题解决方法

也就是说需要修改qsqldriverbase.pri文件,将include($$shadowed($$PWD)/qtsqldrivers-config.pri)这一行注释掉,改成如下的

#include(./configure.pri)

qsqldriverbase.pri

在命令行中使用qmake重新编译
在命令行中使用`qmake`重新编译

使用QtCreator打开mysql.pro工程文件,生成msvc2017_64的mysql驱动

生成Mysql驱动

然后再点击左下角的那个锥子标识进行编译,如下图所示:
点击左下角的那个锥子标识进行编译

可以看到在相应的D:\software\Qt\Qt5.14.2\5.14.2\Src\qtbase\src\plugins\sqldrivers\mysql\mysqlDll目录下生成了基于msvc2017_64的mysql驱动文件的Debug版本的qsqlmysqld.dllqsqlmysqld.lib,Release版本的qsqlmysql.dllqsqlmysql.lib,如下图所示:
生成mysql驱动dll和lib

编译完成后记得将编译后的qsqlmysql.dll以及qsqlmysqld.dll文件拷贝到相应的目录D:\software\Qt\Qt5.14.2\5.14.2\msvc2017_64\plugins\sqldrivers

拷贝mysql驱动到指定目录

查找依赖

MySql 的库(libmysql.dll)有了,驱动(qsqlmysql.dll 和 qsqlmysqld.dll)也有了,将他们拷贝到程序所在目录,就能正常运行啦?哈哈 O(∩_∩)O,可别高兴的太早哦!

理论上确实如此,但对于高版本的 MySql 来说不行,因为 libmysql.dll 还依赖于其他的库。所以如果按照上述做法,还是会出现“QMYSQL driver not loaded”这样的问题!(很多人被里这坑了,怎么都想不明白)

不信的话,用 Dependencies(见:https://github.com/lucasg/Dependencies)查看一下,是不是有很多依赖的库找不到:

libmysql.dll缺少的库

了解之后,现在将这些库文件拷贝到程序所在目录,然后运行程序:


Debug版本-成功连接到数据库

Release版本

至此,在Windows10中使用Qt 5.14.2连接MySQL数据库成功,并且生成了MSVC2017 64位的qsqlmysqld.dll和qsqlmysql.dll驱动。

参考资料

  • QMYSQL driver not loaded 原理及解决方案
  • Qt连接MySql驱动加载失败问题解决方法
  • Qt5.14.2连接MySQL8.0(windows安装版)
  • Qt操作MySql数据库进行增删改查

你可能感兴趣的:(Windows10下使用Qt5.14.2连接mysql-8.0.16-winx64数据库报错:QMYSQL driver not loaded 原理及解决方案)