Windows 基于Visual Studio 开发Qt 6 连接MySQL 8

谁践踏了优雅 2023-10-16 13:41 7阅读 0赞

前提条件：

1、Visual Studio 2022 社区版(免费版)

2、[Qt][]\-6.5.1版本

3、MySQL 8

## Qt 6 配置MySQL 8 动态/静态连接库和MySQL 8 驱动。 ##

![263d846b0fb04d10a06fcb7fb399b1a3.png][]

*  libmysql.dll 和libmysql.lib是QT所需的动态和静态链接库；
 *  qsqlmysql.dll 和qsqlmysql.dll.debug是Qt所需的mysql驱动；

### Qt 6 设置MySQL 8 驱动 ###

本文Qt 6 安装目录地址: D:\\Qt\\6.5.1\\msvc2019\_64\\plugins\\sqldrivers

第一步:将qsqlmysql.dll 和qsqlmysql.dll.debug 拷贝至Qt 6 安装目录下的插件/驱动目录中（ D:\\Qt\\6.5.1\\msvc2019\_64\\plugins\\sqldrivers）

![4719ccd33a624bd18728dd0857353c0a.png][]

第二步：Qt 6 验证MySQL 8 驱动是否安装成功

首先使用Vistual Studio 2022 创建Qt 6 [项目][Link 1]，项目名称为：QtWidgetsApplicationTwo

![30605199a947474cb22acd69d29ea9d0.png][]

选择 Qt Widgets Application 项目，再点击下一步。

![e50e575bdfc140008bb5a7e8473a0d28.png][]

创建项目名称:QWidgetApplicationTwo,再点击下一步。

![a69046cc04d94cbba64fed0613fc46fa.png][]

直接点击Next 按钮。

![d1e2dd1f30b644edb004eb0f1e656cac.png][]

默认Qt 版本、系统、平台和Qt 模块，点击Next 按钮.

![f3d61b51048e47c992c5163563b7a810.png][]

直接点击Finsh，完成项目创建。

运行QtWidgetApplicationTwo 项目的效果。

![84616f8793d54437ad8369baea83445c.png][]

**本章节知识重点:**

首先在对应Qt项目qmark 中的\*.pro文件中设置**Qt += sql** 如下：

Visual Studio 默认Qt 项目中的qmark 文件地址:E:\\visual\_workspace\\QtWidgetsApplicationTwo\\x64\\Debug\\qmake\\temp\\qtvars.proc

原文：

CONFIG += no_fixpath
    QT += core gui widgets

原文添加sql:

CONFIG += no_fixpath
    QT += core gui widgets sql

![43e1937a257f4b73bbae20d96d2bf605.png][]

其次，修改QtWidgetsApplicationTwo.h 头文件对应的实现QtWidgetsApplicationTwo.cpp，在UI初始化函数添加如下代码片段:

// 输出可用数据库
        qDebug() << "available drivers:";
        QStringList drivers = QSqlDatabase::drivers();
        foreach(QString driver, drivers)
        qDebug() << driver;

QtWidgetsApplicationTwo.cpp 源码

#include "QtWidgetsApplicationTwo.h"
    #include "QtSql/QSqlDatabase"
    #include "QtSql/QSqlQuery"
    #include "QString"
    #include "QMessageBox"
    #include "QDebug"
    
    
    QtWidgetsApplicationTwo::QtWidgetsApplicationTwo(QWidget *parent)
        : QMainWindow(parent)
    {
        ui.setupUi(this);
    
        // 输出可用数据库
        qDebug() << "available drivers:";
        QStringList drivers = QSqlDatabase::drivers();
        foreach(QString driver, drivers)
        qDebug() << driver;
    
    }
    
    QtWidgetsApplicationTwo::~QtWidgetsApplicationTwo()
    {}

运行QtWidgetApplicationTwo 项目，在控制台找到Qt 项目支持的数据库驱动信息输出。

![bbba769f78a647419b91acf211708f3d.png][]

### Qt 6 设置 MySQL 8 动态和静态链接库 ###

将libmysql.dll 和libmysql.lib 拷贝至D:\\Qt\\6.5.1\\msvc2019\_64\\bin目录下。

![3e4f3213b1374c0a8226f67c89a4c042.png][]

**本章节知识重点:**

修改QtWidgetsApplicationTwo.h 头文件对应的实现QtWidgetsApplicationTwo.cpp，在UI初始化函数添加如下代码片段:

QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");//首次需要添加数据库驱动(必须在main程序中)，第二次只需QSqlDatabase::database("QMYSQL")（其他文件中，防止多次使用）;
        db.setHostName("192.168.43.10");//设置ip
        db.setPort(3306);//端口号
        db.setDatabaseName("usc");//数据库名称
        db.setUserName("root");//用户名
        db.setPassword("123456");//密码
        QSqlQuery query = QSqlQuery(db);//db对象
        bool ok = db.open();//连接数据库
        if (db.open()) {
            QMessageBox::information(this, "infor", "success");//成功
            qDebug() << "success!!!";
    
        }
        else {
            QMessageBox::information(this, "infor", "open failed");
            qDebug() << "error open database because";//失败
        }

运行QtWidgetApplicationTwo 项目，在控制台找到Qt 项目支持的数据库驱动信息输出。

![622f817b5b344e0f880773d5438ddd2c.png][]

![3517cfa3bddb4c0fa6b27a61776a6fc5.png][]

![3cebbb867131496bbb4d139152023f89.png][]

## Qt 6 项目配置MySQL 8 驱动 遇到的问题 ##

> 问题一: error LNK2019: 无法解析的外部符号 "\_\_declspec(dllimport) public: static class QList<class QString> \_\_cdecl QSqlDatabase::drivers(void)" (\_\_imp\_?drivers@QSqlDatabase@@SA?AV?$QList@VQString@@@@XZ)，函数 "public: \_\_cdecl QtWidgetsApplicationTwo::QtWidgetsApplicationTwo(class QWidget \*)" (??0QtWidgetsApplicationTwo@@QEAA@PEAVQWidget@@@Z) 中引用了该符号  
> 1>E:\\visual\_workspace\\QtWidgetsApplicationTwo\\x64\\Debug\\QtWidgetsApplicationTwo.exe : fatal error LNK1120: 1 个无法解析的外部命令

产生此问题原因：Qt 项目没有添加Qt SQL 模块。

解决办法:

拓展->Qt VS Tool ->Qt Project Settings

![ea6a37cf14fa4bbbb377708b5a6d0d88.png][]

上图，是VS 创建Qt 项目默认加载的Qt 模块。

![27433ffa69364495a27e365ba575f98f.png][]

上图，是为Qt 项目添加的sql 模块.

> 问题二：QSqlDatabase:MYSQL driver not loaded

产生此问题的原因：从CSDN 资源下载器下载的Qt 6 关于MySQL 8.0.23 驱动有错误才导致上述问题的产生。

解决办法如下:

[Qt 对应MySQL 驱动下载][Qt _MySQL] ，[https://github.com/thecodemonkey86/qt\_mysql\_driver/releases][https_github.com_thecodemonkey86_qt_mysql_driver_releases]

根据自己本地Qt 版本和平台架构选择对应的MySQL 驱动包.

![de6150ffacb042a7b47c403813dce0c9.png][]

本文演示Qt 版本详情信息：

Qt 6.5.1\_64位

Windows 系统

基于MSVC\_2019

我选择的驱动版本为:qsqlmysql.dll\_Qt\_SQL\_driver\_6.5.1\_MSVC2019\_64-bit.zip

解压后的目录：

![507b95f42d504f5b800c0863ed9c385a.png][]

1、 将上图目录中libmysql.dll 拷贝至D:\\Qt\\6.5.1\\msvc2019\_64\\bin目录下，替换原有libmysql.dll 并删除libmysql.lib。

2、将sqldrivers 目录中的qsqlmysql.dll 和qsqlmysqld.dll拷贝至Qt 6 安装目录下的插件/驱动目录中（ D:\\Qt\\6.5.1\\msvc2019\_64\\plugins\\sqldrivers），替换原有qsqlmysql.dll 并删除qsqlmysql.dll.debug

## Qt 6 知识拓展 ##

### Qt 版本信息输出 ###

#include <QtCore/QCoreApplication>
    #include <QSysInfo>
    #include <QDebug>
    
    int main(int argc, char* argv[])
    {
    	QCoreApplication a(argc, argv);
    
    	qDebug() << "buildAbi: " << QSysInfo::buildAbi();
    	qDebug() << "buildCpuArchitecture: " << QSysInfo::buildCpuArchitecture();
    	qDebug() << "currentCpuArchitecture: " << QSysInfo::currentCpuArchitecture();
    	qDebug() << "kernelType: " << QSysInfo::kernelType();
    	qDebug() << "kernelVersion: " << QSysInfo::kernelVersion();
    	qDebug() << "machineHostName: " << QSysInfo::machineHostName();
    	qDebug() << "prettyProductName: " << QSysInfo::prettyProductName();
    	qDebug() << "productType: " << QSysInfo::productType();
    	qDebug() << "productVersion: " << QSysInfo::productVersion();
    
    	return a.exec();
    }

控制台输出结果:

buildAbi:  "x86_64-little_endian-llp64"
    buildCpuArchitecture:  "x86_64"
    currentCpuArchitecture:  "x86_64"
    kernelType:  "winnt"
    kernelVersion:  "10.0.22621"
    machineHostName:  "LAPTOP-8R0KHL88"
    prettyProductName:  "Windows 11 Version 22H2"
    productType:  "windows"
    productVersion:  "11"

### 查看 Docker容器中MySQL 版本信息 ###

[root@localhost ~]# docker ps
    CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                                  NAMES
    241448b9f8d6        mysql:8.0.23        "docker-entrypoint.s…"   7 months ago        Up 3 weeks          0.0.0.0:3306->3306/tcp, 33060/tcp                      mysql
    1c3d38b948ba        zookeeper           "/docker-entrypoint.…"   13 months ago       Up 3 weeks          2888/tcp, 3888/tcp, 0.0.0.0:2181->2181/tcp, 8080/tcp   zookeeper
    62233dfad35b        minio/minio         "/usr/bin/docker-ent…"   13 months ago       Up 3 weeks                                                                 minio-server
    [root@localhost ~]# docker exec -it 241448b9f8d6 bash
    root@241448b9f8d6:/# mysql --version
    mysql  Ver 8.0.23 for Linux on x86_64 (MySQL Community Server - GPL)

### 相关参考文章 ###

Qt 编译MySQL 8 驱动:[Qt Creator 6.1.0连接MySql8.0.23配置][Qt Creator 6.1.0_MySql8.0.23]

Qt 连接MySQL 数据库: [Qt配置mysql8][Qt_mysql8]

[Qt]: https://so.csdn.net/so/search?q=Qt&spm=1001.2101.3001.7020
[263d846b0fb04d10a06fcb7fb399b1a3.png]: https://img-blog.csdnimg.cn/263d846b0fb04d10a06fcb7fb399b1a3.png
[4719ccd33a624bd18728dd0857353c0a.png]: https://img-blog.csdnimg.cn/4719ccd33a624bd18728dd0857353c0a.png
[Link 1]: https://so.csdn.net/so/search?q=%E9%A1%B9%E7%9B%AE&spm=1001.2101.3001.7020
[30605199a947474cb22acd69d29ea9d0.png]: https://img-blog.csdnimg.cn/30605199a947474cb22acd69d29ea9d0.png
[e50e575bdfc140008bb5a7e8473a0d28.png]: https://img-blog.csdnimg.cn/e50e575bdfc140008bb5a7e8473a0d28.png
[a69046cc04d94cbba64fed0613fc46fa.png]: https://img-blog.csdnimg.cn/a69046cc04d94cbba64fed0613fc46fa.png
[d1e2dd1f30b644edb004eb0f1e656cac.png]: https://img-blog.csdnimg.cn/d1e2dd1f30b644edb004eb0f1e656cac.png
[f3d61b51048e47c992c5163563b7a810.png]: https://img-blog.csdnimg.cn/f3d61b51048e47c992c5163563b7a810.png
[84616f8793d54437ad8369baea83445c.png]: https://img-blog.csdnimg.cn/84616f8793d54437ad8369baea83445c.png
[43e1937a257f4b73bbae20d96d2bf605.png]: https://img-blog.csdnimg.cn/43e1937a257f4b73bbae20d96d2bf605.png
[bbba769f78a647419b91acf211708f3d.png]: https://img-blog.csdnimg.cn/bbba769f78a647419b91acf211708f3d.png
[3e4f3213b1374c0a8226f67c89a4c042.png]: https://img-blog.csdnimg.cn/3e4f3213b1374c0a8226f67c89a4c042.png
[622f817b5b344e0f880773d5438ddd2c.png]: https://img-blog.csdnimg.cn/622f817b5b344e0f880773d5438ddd2c.png
[3517cfa3bddb4c0fa6b27a61776a6fc5.png]: https://img-blog.csdnimg.cn/3517cfa3bddb4c0fa6b27a61776a6fc5.png
[3cebbb867131496bbb4d139152023f89.png]: https://img-blog.csdnimg.cn/3cebbb867131496bbb4d139152023f89.png
[ea6a37cf14fa4bbbb377708b5a6d0d88.png]: https://img-blog.csdnimg.cn/ea6a37cf14fa4bbbb377708b5a6d0d88.png
[27433ffa69364495a27e365ba575f98f.png]: https://img-blog.csdnimg.cn/27433ffa69364495a27e365ba575f98f.png
[Qt _MySQL]: https://github.com/thecodemonkey86/qt_mysql_driver
[https_github.com_thecodemonkey86_qt_mysql_driver_releases]: https://github.com/thecodemonkey86/qt_mysql_driver/releases
[de6150ffacb042a7b47c403813dce0c9.png]: https://img-blog.csdnimg.cn/de6150ffacb042a7b47c403813dce0c9.png
[507b95f42d504f5b800c0863ed9c385a.png]: https://img-blog.csdnimg.cn/507b95f42d504f5b800c0863ed9c385a.png
[Qt Creator 6.1.0_MySql8.0.23]: https://blog.csdn.net/weixin_42043127/article/details/115363582
[Qt_mysql8]: https://blog.csdn.net/qq_44464101/article/details/126985148