QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了)
作者:mmseoamin日期:2023-12-25

1.MySQL数据库的下载,这里只讲免安装的。

①.首先:要先进入mysql官网里MySQL :: MySQL Downloads。

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第1张

②.向下拉,找到以下位置:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第2张③.下载社区版的Server: 

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第3张 ④.根据系统选择对应版本:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第4张

⑤.直接点击红框位置即可开始下载: 

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第5张

 ⑥.文件下载后解压到英文目录,我直接解压到D盘根目录:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第6张

⑦.在mysql目录下创建一个my.ini配置文件,里面写的代码是mysql的一些基本配置

[mysql]
default-character-set = utf8
[mysqld]
#跳过SSL
skip_ssl
#端口
port = 3306
#mysql安装目录
basedir = D:/mysql-8.0.31-winx64
#mysql数据存放目录
datadir = D:/mysql-8.0.31-winx64/data
#允许最大连接数
max_connections = 1024
#允许连接失败的次数
max_connect_errors=10
#服务端默认使用字符集
character-set-server = utf8
#默认存储引擎
default-storage-engine = INNODB

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第7张

⑧.新建系统变量

为了方便登录操作mysql,在这里我们设置一个全局变量

点击"我的电脑"-->"属性"-->''高级系统设置''-->''环境变量'',接下来如下图所操作

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第8张

把新建的mysql变量添加到Path路径变量中,点击确定,即完成:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第9张

 配置完成之后,每当我们想要用命令行使用mysql时,只需要win+R,-->输入"cmd"打开命令行,之后输入登录sql语句即可

 2.MySQL数据库的配置

①.以管理员身份打开命令行,并跳转到解压的文件夹中的bin文件夹内:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第10张

②.安装mysql的服务:mysqld --install

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第11张

如果提示以下错误,则需要百度下载一个响应的dll文件,并将文件拷贝到D:\mysql-8.0.31-winx64\bin文件夹内。重新运行mysqld --install即可

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第12张

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第13张

 ③.初始化mysql : mysqld --initialize --console

注意,初始化的命令有很多,差别不大:

mysqld --initialize-insecure:自动生成无密码的root用户,
mysqld --initialize:自动生成带随机密码的root用户,
mysqld --initialize --user=mysql --console:生成随机密码并显示在控制台窗口,

在这里,初始化会产生一个随机密码,如下图框框所示,记住这个密码,后面会用到

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第14张

 ④.开启mysql的服务(net start mysql)

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第15张

⑤.登录验证,(mysql -u root -p)mysql是否安装成功!(要注意上面产生的随机密码,不包括前面符号前面的空格,否则会登陆失败),如果和下图所示一样,则说明你的mysql已经安装成功!注意,,一定要先开启服务,不然会登陆失败,出现拒绝访问的提示符!!! 

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第16张

 ⑥.修改密码

初始密码太复杂,不方便记忆,所以修改一下, alter user 'root'@'localhost' identified by 'root';

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第17张

 ⑦.退出并重新登录

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第18张

⑧.新建一个数据库

如: create database test;   (不要忘记分号!!!!!!,数据库的名字就是test,可以改为其他)

新建完后可以查看当前数据库:show databases;

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第19张

3. 常见问题处理

①.有时遇到服务无法开启的情况

这是因为my.ini文件指令不合法导致的。

可以先找合适的ini内容,上面的内容是我测试过的,然后把data文件夹删除

然后删除服务:使用命令sc delete mysql

再重新初始化mysql:mysqld --initialize --console,初始化成功可以看到提供的初始密码

再重新安装服务:mysqld --install mysql

再启动服务:net start mysql

再登录mysql:mysql -u root -p ,随后的密码输入上面提供的初始密码

再修改密码: alter user 'root'@'localhost' identified by '123456';     这里修改为123456了

再退出: exit

再重新登录试试:mysql -u root -p ,随后的密码用新密码如123456

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第20张

②.有时候登录时遇到ERROR 2061 (HY000): Authentication plugin 'caching_sha2_password' reported error: Authentication requires secure connection.

这时候只需要把登录指令改为:mysql -u root -p --get-server-public-key

此时就可以登录成功,但是成功以后下次登录还会遇到这样的问题,并且QT等也会提示这个问题。

所以得用以下办法,分别复制下面命令并执行:

     //修改加密规则(可以直接复制)

     ALTER USER 'root'@'localhost' IDENTIFIED BY 'password' PASSWORD EXPIRE NEVER;

    //更新一下用户的密码(可以直接复制)

    ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

   //刷新权限(可以直接复制)

    FLUSH PRIVILEGES;

    //重置密码,注意里面的123456是我设置的密码。

   alter user 'root'@'localhost' identified by '123456';

这样登录就不会再提示错误了,看截图:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第21张

4.QT 登录测试

新建一个工程,我用的QT版本是5.13.2。据说5.13之前的版本都自带MYSQL驱动,5.13及以后得自己编译安装。后面会讲。

①.文件代码添加

pro文件新增:QT +=sql

mainwindow.h中添加:  #include

mainwindow.cpp中代码:

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include 
#include 
#include 
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    qDebug() << QSqlDatabase::drivers() ;
    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
        db.setHostName("127.0.0.1");  //连接本地主机
        db.setPort(3306);
        db.setDatabaseName("test");
        db.setUserName("root");
        db.setPassword("123456");
        bool ok = db.open();
        if (ok){
            QMessageBox::information(this, "infor", "link success");
        }
        else {
            QMessageBox::information(this, "infor", "link failed");
            qDebug()<<"error open database because"< 

②.运行

连接成功会得到如下提示,如果不是这样也不要急,后面接着讲。

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第22张

 下面红框里这一行是支持的数据库驱动,可以看到是支持QMYSQL的,所以才能连接成功,如果没有QMYSQL,就需要安装驱动,这个比较麻烦点,还得重装QT。

5.QT mysql驱动安装

①重装qt,注意选中sources,如果之前安装时已选的就不用重装了

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第23张

 ②.去MySQL :: Download MySQL Connector/C (Archived Versions)下载mysql驱动包并解压。

       只需要其中的libmysql.dll,应该这个文件跟前面下载的数据库软件中D:\mysql-8.0.31-winx64\lib的文件是一致的。我是单独下载的驱动,有兴趣的朋友可以直接使用数据库软件中的这个dll文件试一下。

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第24张

 ③.用QT打开安装目录中的mysql.pro工程,

注意:我是直接安装到D盘Qt文件夹下的。

 成功安装qt源码之后在D:\Qt\Qt5.13.2\5.13.2\Src\qtbase\src\plugins\sqldrivers\mysql   目录中找到mysql.pro 工程文件,打开之后进行编辑QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第25张

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第26张

打开qtsqldrivers.pri文件,注释掉相关语句

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第27张

 编译mysql工程,在以下目录复制4个生成的文件到下图目录。

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第28张

复制到这里:

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第29张

 最后复制mysql目录(D:\Qt\mysql-connector-c-6.1.11-winx64\lib)下的libmysql.dll到 D:\Qt\Qt5.13.2\5.13.2\mingw73_64\bin目录。

如此即可完成QT的MYSQL驱动安装。

安装是否成功同样可以用前面新建的QT工程测试。

6. MYSQL 客户端软件安装

这里使用MYSQL官方提供的MySQL Workbench 8.0.31

下载地址:MySQL :: Download MySQL Workbench

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第30张

下载完后安装时可能需要VC2019支持:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第31张

下载地址在这里: 

Latest supported Visual C++ Redistributable downloads | Microsoft Learn

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第32张

 VC2019支持包安装完后,MySQL Workbench 8.0.31的安装就很简单了,一路NEXT就可以

安装完成后界面如下:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第33张

点击这里就可以进入数据库:

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第34张

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第35张

7.ODBC连接方式

QT与mysql除了可以通过QMYSQL驱动连接以外,还可以使用通用接口QODBC

我目前QT支持的驱动如下:"QSQLITE", "QMYSQL", "QMYSQL3", "QODBC", "QODBC3", "QPSQL", "QPSQL7"

要使用ODBC,首先需要去MYSQL官网下载ODBC的驱动:

MySQL :: Download Connector/ODBC

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第36张

直接一路NEXT就可以

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第37张

然后去控制面板/管理工具/ODBC数据源64位,双击打开数据源管理程序

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第38张

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第39张

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第40张

点击Test,正常会弹出下面连接成功的提示消息。

 QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第41张

 测试程序跟QMYSQL差不多

    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
    db.setDatabaseName("mysql");
//    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
//    //db.setHostName("127.0.0.1");  //连接本地主机
//    db.setHostName("localhost");  //连接本地主机
//    db.setDatabaseName("test");
    db.setPort(3306);    
    db.setUserName("root");
    db.setPassword("123456");
    bool ok = db.open();
    if (ok){
        QMessageBox::information(this, "infor", "link success");
    }
    else {
        QMessageBox::information(this, "infor", "link failed");
        qDebug()<<"error open database because"< 

 至此,连接成功了。

8.常用指令

包含新建表、单条插入,多条插入,修改、查询、删除表,关闭连接,懂这些就满足基本项目需求了。。这些对QMYSQL和QODBC都通用。

    //创建表
      QSqlQuery query(db);
      ok = query.exec("create table student(id int primary key auto_increment, "
                      "name varchar(255), age int, score int)ENGINE=INNODB;");
      if (!ok){
          qDebug()<< "create table:" << query.lastError();
      }
      //单行插入
      ok = query.exec("insert into student(id, name, age, score) values(1, '张三', 18, 80)");
      if (!ok){
          qDebug()<< "insert into error:" << query.lastError();
      }
      //多行插入
      query.prepare("insert into student(name, age, score) values(?,?,?)");   //?是占位符
      QVariantList name;
      QVariantList age;
      QVariantList score;
      name << "李四" << "王五" << "赵六";
      age << 19 << 20 << 21;
      score << 85 << 90 << 95;
      //按顺序给字段绑定相应的值
      query.addBindValue(name);
      query.addBindValue(age);
      query.addBindValue(score);
      //执行预处理命令
      ok = query.execBatch();
      if (!ok){
          qDebug()<< "execBatch error:" << query.lastError();
      }
      //修改
      ok = query.exec("update student set score=100 where name='张三'");
      if (!ok){
          qDebug()<< "update error:" << query.lastError();
      }
      //查询
      query.exec(QString("select id from student where name='赵六'"));
      if (!ok){
          qDebug()<< "select *from error:" << query.lastError();
      }
      else{
          query.next();
          qDebug() << query.value(0).toInt();
      }
      //遍历
      ok = query.exec("select *from student");
      if (!ok){
          qDebug()<< "select *from error:" << query.lastError();
      }
      else{
          while(query.next())   //遍历完为false
          {
              //方式1:以下标
              qDebug()<< query.value(0).toInt()<< query.value(1).toString()
                      << query.value(2).toInt()<< query.value(3).toInt();
              //方式2:以字段
              //qDebug()<< query.value("id").toInt()<< query.value("name").toString()
                          //<< query.value("age").toInt()<< query.value("score").toInt();
          }
      }
      //删除某一行
      ok = query.exec("delete from student where name='张三'");
      if (!ok){
          qDebug()<< "delete error:" << query.lastError();
      }
      //删除整个表
      ok = query.exec("drop table student");
      if (!ok)
      {
          qDebug()<< "drop table error:" << query.lastError();
      }
      db.close();//关闭数据库

9.项目发布

常规的发布过程不再说,区别是需要把libmysql.dll拷贝到发布程序所在目录

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第42张

QT 5.13 使用MySQL数据库,含MYSQL安装和QT驱动安装及错误讲解、以及QMYSQL和QODBC两种连接方式以及常用指令,(非常全面了),第43张