Qt 6以上版本都试用 连接 MySQL 数据库全流程(CMake 环境)

起因是因为学qt学到数据库操作了,结果报下面的错误:

复制代码
qt.sql.qsqldatabase: QSqlDatabase: QMYSQL driver not loaded
qt.sql.qsqldatabase: available drivers: QSQLITE QMYSQL QODBC QPSQL ...

真的给我整崩溃了,网上大部分都是通过.pro文件去配置,qsqlmysql.dll这个东西,但是这个操作在QT6以上版本来做是非常痛苦的,于是我去github上找方法,去找资源,结果真的找到了,话不多说,上链接!!!

链接(有各种版本的)

地址https://github.com/thecodemonkey86/qt_mysql_driver?utm_source=chatgpt.com

(你必须下你对应的版本,要不然也连接不上,如果上不上去github的留言我发你)

一、环境准备

项目 版本/说明
Qt 版本 6.8.3(你必须下你对应的版本,要不然也连接不上)
编译器 MinGW 13.1.0 64-bit
数据库 MySQL 8.0(或 MariaDB)
CMake ≥ 3.16

二、常见报错原因分析

很多人连不上 MySQL 是因为以下几点:

  1. qsqlmysql.dll 驱动文件缺失或版本不匹配

    Qt 访问 MySQL 时其实是通过一个插件(qsqlmysql.dll)来实现的。

    这个插件必须和你的 Qt 版本、编译器完全对应。

三、放置方法:

这三个文件建议放在:E:\Qt\6.8.3\mingw_64\bin\

(也可以在E:\Qt\6.8.3\mingw_64\plugins\sqldrivers\)这里也放一份。

这两个文件当然就放在自己安装的那个文件夹下,我的地址(E:\QT\6.8.3\mingw_64\plugins\sqldrivers\)要是你没有的话就说明你的source那个没下。

MySQL自己的连接当然也要放,

在自己下的MySQL文件下面找到这两个,复制一份到上面提到的(E:\QT\6.8.3\mingw_64\plugins\sqldrivers\)这个地址下去。

这些配置完了也就差不多成功了,但是如果还是报错,可以把上面提到的所有文件放在:

(G:\code_all\qt\mySql_test\build\Desktop_Qt_6_8_3_MinGW_64_bit-Debug)

这个目录下,这个路径就是你自己创建的工程路径的debug(如果你用的是release(也就是常说的发行版)),就复制到你的发行版下。

四、常见问题总结

问题 原因 解决方案
QMYSQL driver not loaded 驱动文件找不到 qsqlmysql.dll 放在 sqldrivers/
QMYSQL driver loaded but connection failed 用户名或密码错误 检查 MySQL 配置
SSL handshake failed 缺少 libssl / libcrypto 拷贝这两个 DLL
Unknown database 数据库不存在 手动创建数据库

五、结语

Qt 连接数据库其实并不复杂,最麻烦的就是"驱动版本匹配"问题。

只要搞清楚 qsqlmysql.dll + libmysql.dll + OpenSSL 三者的对应关系,

一次配置好环境,后续所有项目都能直接使用。

相关推荐
Lhan.zzZ2 小时前
笔记_2026.4.28_004
c++·ide·笔记·qt
HUGu RGIN3 小时前
MySQL--》如何在MySQL中打造高效优化索引
android·mysql·adb
HackTwoHub4 小时前
AI大模型网关存在SQL注入、附 POC 复现、影响版本LiteLLM 1.81.16~1.83.7(CVE-2026-42208)
数据库·人工智能·sql·网络安全·系统安全·网络攻击模型·安全架构
l1t4 小时前
DeepSeek总结的DuckLake构建基于 SQL 原生表格式的下一代数据湖仓
数据库·sql
KmSH8umpK4 小时前
Redis分布式锁从原生手写到Redisson高阶落地,附线上死锁复盘优化方案进阶第八篇
数据库·redis·分布式
TDengine (老段)5 小时前
从施工监测到运营预警,桥科院用 TDengine 提升桥梁数据管理能力
大数据·数据库·物联网·时序数据库·tdengine·涛思数据
S1998_1997111609•X6 小时前
论mysql国盾shell-sfa犯罪行为集团下的分项工程及反向注入原理尐深度纳米算法下的鐌檵鄐鉎行为
网络·数据库·网络协议·百度·开闭原则
KmSH8umpK7 小时前
Redis分布式锁从原生手写到Redisson高阶落地,附线上死锁复盘优化方案进阶第七篇
数据库·redis·分布式
BU摆烂会噶8 小时前
【LangGraph】持久化实现的三大能力——时间旅行
数据库·人工智能·python·postgresql·langchain
l1t9 小时前
DeepSeek总结的DuckLake 入门
数据库