qt5.14.2连mysql8.0
Qt 5.14.2 默认不提供预编译的 MySQL 驱动，直接连接 MySQL 8.0 通常会报错 QMYSQL driver not loaded。核心解决方案是手动编译驱动并解决 MySQL 8.0 的新身份验证协议问题。
一、环境准备与验证
1.版本对齐：确保 Qt 编译器（MinGW/MSVC）与 MySQL Server 8.0 的位数一致（推荐均为 64 位）。
2.安装源码：Qt 安装时必须勾选 Source组件，否则无法编译驱动
二、手动编译 MySQL 驱动（Windows 示例）
1.定位源码：进入 Qt 源码目录
Qt\Qt5.14.2\5.14.2\Src\qtbase\src\plugins\sqldrivers\mysql
2.修改 mysql.pro文件：
用 Qt Creator 打开 mysql.pro，注释原配置并添加你的 MySQL 8.0 路径（路径中不要有空格或中文）。
pro
TARGET = qsqlmysql# 注释掉这一行
# QMAKE_USE += mysqlHEADERS += $PWD/qsql_mysql_p.h
SOURCES += $PWD/qsql_mysql.cpp $PWD/main.cpp# 添加你的 MySQL 8.0 路径（请根据实际安装路径修改）
INCLUDEPATH += "C:/MySQL/ProgramFiles/MySQLServer8.0/include"
LIBS += "C:/MySQL/ProgramFiles/MySQLServer8.0/lib/libmysql.lib"OTHER_FILES += mysql.json
PLUGIN_CLASS_NAME = QMYSQLDriverPlugin
include(../qsqldriverbase.pri)
3.编译生成：
使用与你的 Qt 环境匹配的 Kit（如 Desktop Qt 5.14.2 MinGW 64-bit）构
建项目。
编译成功后，会在 plugins\sqldrivers或 lib目录下生成 qsqlmysql.dll等
文件。
4.部署驱动文件：
将生成的 qsqlmysql.dll（Release版）和 qsqlmysqld.dll（Debug版）复
制到：
Qt\Qt5.14.2\5.14.2\mingw73_64\plugins\sqldrivers
将 MySQL 8.0 的 libmysql.dll（位于 MySQL 的 bin或 lib目录）复制到：
Qt\Qt5.14.2\5.14.2\mingw73_64\bin
三、代码连接与 MySQL 8.0 认证修复
1.基础连接代码：
在 .pro文件中添加 QT += sql，然后使用以下代码测试
cpp
#include <QSqlDatabase>
#include <QSqlError>
#include <QDebug>QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
db.setHostName("127.0.0.1"); // 或你的服务器IP
db.setPort(3306);
db.setDatabaseName("your_database");
db.setUserName("root");
db.setPassword("your_password");if (!db.open()) {qDebug() << "Connection error:" << db.lastError().text();
} else {qDebug() << "Connected!";
}
2.解决 MySQL 8.0 认证协议错误：
如果报错 "Client does not support authentication protocol requested by server"，说明 MySQL 8.0 默认的 caching_sha2_password加密方式
Qt5.14 不支持。
解决方案（二选一）：
推荐：修改用户密码插件（在 MySQL 命令行中执行）：
sql
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password';
FLUSH PRIVILEGES;
ini
[mysqld]
default_authentication_plugin=mysql_native_password