记录：Qt5.12+VS2019编译32位MYSQL8.0驱动

傷城~ 2023-07-19 12:12 36阅读 0赞

# 第零步，说明 #

从Qt5.12.4（待验证）版本开始Qt就没带MYSQL的驱动了，需要自己编译。我也是折腾了好久才成功了，特此记录。

# 第一步，安装MYSQL8.0 #

我是在官网下载的最新版本的\*.msi安装程序，装完才发现数据库是64位，但是connector可以是32位的。此外，编译Qt MYSQL驱动需要C的connector而不是C++的。因为我Qt是32位，所以还需要装x86的C connector。

![20200330230904390.png][]

打开MYSQL installer安装管理程序，点击右侧【add】并添加C的connector组件安装上就行了。

（2020-05-17补充）最近又打开看了下，installer里C的connector不见了，不过也可以直接去网上搜C链接器的下载链接。

![20200330225528778.png][]

可能有些版本没有这个C的驱动，可以自己单独下载装上：[https://downloads.mysql.com/archives/c-c/][https_downloads.mysql.com_archives_c-c]

![20200611222233681.png][]

MYSQL官网链接：[https://dev.mysql.com/downloads/mysql/][https_dev.mysql.com_downloads_mysql]

Qt相关文档：[https://doc.qt.io/qt-5/sql-driver.html\#qmysql][https_doc.qt.io_qt-5_sql-driver.html_qmysql]

# 第二步，使用QtCreator编译MYSQL驱动插件 #

我先是根据Qt官网的文档使用命令行，结果发现可能我的环境变量没弄好没法用，还是参照百度上的博客用QtCreator来编译。

首先，打开源码MYSQL插件的工程（我的路径E:\\Qt\\qt-everywhere-src-5.12.4\\qtbase\\src\\plugins\\sqldrivers\\mysql）。

然后，修改pro文件，去掉QMAKE\_USE这一行，把MYSQL的C库添加进来：

#QMAKE_USE += mysql
    
    INCLUDEPATH +="C:/Program Files (x86)/MySQL/MySQL Connector C 6.1/include"
    LIBS +="C:/Program Files (x86)/MySQL/MySQL Connector C 6.1/lib/libmysql.lib"

然后构建。（2020-06-11补充）构建可能会提示 Project ERROR: msvc-version.conf loaded but QMAKE\_MSC\_VER isn't set。直接去安装目录修改配置文件，我的路径是：E:\\Qt\\QtOnline\\5.15.0\\msvc2019\\mkspecs\\common\\msvc-version.conf

在前面加一句QMAKE\_MSC\_VER = 1919（对应自己的编译器版本）：

![2020061121034434.png][]

开始我以为没构建成功，后来发现构建出来的东西莫名其妙跑到顶层目录下了：

![20200330231948352.png][]

我们需要的就是plugins文件夹里的dll。

1.可以手动把dll放到Qt安装包目录的sqldrivers里：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70][]

2.（2020-06-11补充）也可以在构建时加上两个 make 步骤，让他自己安装到目录下（debug-install和release-install）：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 1][]

为了调试方便，我把MYSQL目录下的libmysql.dll也放到Qt安装目录的bin文件夹下：

![20200330233443920.png][]

拷贝完这两个就可以开始测试了。

参照博客：[https://www.cnblogs.com/szitcast/p/11105899.html][https_www.cnblogs.com_szitcast_p_11105899.html]

# 第三步，测试 #

新建Qt工程，pro里加上sql模块：

QT += sql

然后随便加几句测试代码：

#include <QSqlDatabase>
    #include <QSqlQuery>
    #include <QSqlError>
    #include <QDebug>
    
    void test_mysql()
    {
        qDebug()<<QSqlDatabase::drivers();
    
        QSqlDatabase db=QSqlDatabase::addDatabase("QMYSQL");
        db.setHostName("localhost");
        db.setPort(3306);
        db.setUserName("root");
        db.setPassword("qq654344883");
        db.setDatabaseName("mysql_db");
        if(db.open()){
            QSqlQuery query;
            if(query.exec(R"(show global variables like "%datadir%";)")){
                if(query.next()){
                    qDebug()<<query.value(0).toString()<<query.value(1).toString();
                }
            }else{
                qDebug()<<query.lastError();
            }
            db.close();
        }else{
            qDebug()<<db.lastError();
        }
    }

第一次运行可能会出错，lastError()显示（QSqlError("2059", "QMYSQL: Unable to connect", "Authentication plugin 'caching\_sha2\_password' cannot be loaded")）。经查是MYSQL8.0改变了加密规则，MYSQL8.0之前的版本中加密规则是mysql\_native\_password,而在MYSQL8.0之后,加密规则是caching\_sha2\_password。

这里我选择把用户登陆密码规则设置为mysql\_native\_password。

打开MYSQL的命令行工具（MySql 8.0 Command Line Client），执行：

use mysql;
    alter user 'root'@'localhost' identified with mysql_native_password by '密码';

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 2][]

再次运行我们的测试代码：

![20200330235507165.png][]

大功告成！！！

参考博客：[https://msd.misuland.com/pd/3255818100674662202][https_msd.misuland.com_pd_3255818100674662202]

[20200330230904390.png]: /images/20230528/f55dec62e8ae4c989852327f8acfe112.png
[20200330225528778.png]: /images/20230528/b2568ff19c404ad4a816e5b4b2821729.png
[https_downloads.mysql.com_archives_c-c]: https://downloads.mysql.com/archives/c-c/
[20200611222233681.png]: /images/20230528/2ed38ab924184b7ca0fd85921f17c513.png
[https_dev.mysql.com_downloads_mysql]: https://dev.mysql.com/downloads/mysql/
[https_doc.qt.io_qt-5_sql-driver.html_qmysql]: https://doc.qt.io/qt-5/sql-driver.html#qmysql
[2020061121034434.png]: /images/20230528/4cfd261a02ea4f3eb09325b363525bd0.png
[20200330231948352.png]: /images/20230528/57d9425e79894d04a04c7aa784de286f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70]: /images/20230528/217e1c53c8fd4eb7a2869a1bf0805d71.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 1]: /images/20230528/21dd403c4b4f415386a471b4fe90061d.png
[20200330233443920.png]: /images/20230528/a58c1781e22a4c039211a1c8abbd7271.png
[https_www.cnblogs.com_szitcast_p_11105899.html]: https://www.cnblogs.com/szitcast/p/11105899.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70 2]: /images/20230528/a932ddd78e614a129c4e59cd6cc422cd.png
[20200330235507165.png]: /images/20230528/2402525049bd4c3798790712b53fc9f9.png
[https_msd.misuland.com_pd_3255818100674662202]: https://msd.misuland.com/pd/3255818100674662202