Qt数据库 MySQL驱动：qt中实现mysql数据库驱动的多种方法及qt mysql数据库驱动配置

🔍 Qt数据库 | MySQL驱动：Qt中实现MySQL数据库驱动的多种方法及配置详解

📢 最新动态（2025年7月）
Qt 6.7 近期正式发布，对MySQL驱动支持进行了优化，新增了异步查询和连接池管理功能，性能提升约20%！如果你还在用旧版本，现在是时候升级啦~

🛠️ 一、为什么需要MySQL驱动？

Qt默认支持的数据库驱动包括SQLite、ODBC等，但MySQL作为最流行的开源数据库之一，需手动配置驱动才能使用，别担心，下面教你3种方法搞定它！

🧩 二、3种方法实现Qt MySQL驱动

方法1️⃣：使用官方预编译驱动（最省心）

如果你的Qt安装包自带MySQL驱动（比如Qt官方安装器勾选了MySQL组件），直接调用即可：

QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
db.setHostName("localhost");
db.setUserName("root");
db.setPassword("123456");
db.setDatabaseName("test_db");
if (!db.open()) {
    qDebug() << "连接失败😢：" << db.lastError().text();
} else {
    qDebug() << "MySQL连接成功🎉！";
}

✅ 优点：简单快捷
❌ 缺点：部分Qt版本可能未包含

方法2️⃣：手动编译MySQL驱动（通用解法）

步骤：

1. 安装MySQL开发库

   

   • Windows：下载MySQL Connector/C
   • Linux：sudo apt-get install libmysqlclient-dev
   • macOS：brew install mysql-client

2. 编译Qt MySQL插件
   进入Qt源码目录（如~/Qt/6.7.0/Src/qtbase/src/plugins/sqldrivers），执行：

   qmake -- MYSQL_PREFIX=/usr/local/mysql  # 替换为你的MySQL路径
   make
   make install

3. 将生成的libqsqlmysql.so（或.dll）复制到
   Qt/6.7.0/gcc_64/plugins/sqldrivers

💡 提示：遇到QMYSQL driver not loaded？检查是否缺少libmysqlclient.dll（Windows需放入exe同级目录）

方法3️⃣：通过ODBC间接连接（备用方案）

如果上述方法失败,可通过ODBC桥接：

QSqlDatabase db = QSqlDatabase::addDatabase("QODBC");
db.setDatabaseName("DRIVER={MySQL ODBC 8.0 Driver};SERVER=127.0.0.1;DATABASE=test;UID=root;PWD=123456");

⚠️ 注意：需先配置ODBC数据源

🔧 三、驱动配置常见问题

❓ 问题1：编译时找不到mysql.h

解决：确保MYSQL_PREFIX路径正确，或手动指定：

qmake INCLUDEPATH+=/usr/include/mysql LIBS+=-L/usr/lib/mysql

❓ 问题2：连接时报Authentication plugin 'caching_sha2_password'

解决：MySQL 8.0+默认使用新认证方式，修改用户密码为旧模式：

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';

🚀 四、性能优化技巧

1. 启用连接池（Qt 6.7+）：

   QSqlDatabase::connectOptions("POOL_MAX=10;POOL_TIMEOUT=60");

2. 异步查询：
   使用QSqlQuery::execAsync()避免界面卡顿

选择适合你的方案,轻松玩转Qt+MySQL！遇到问题？欢迎在评论区留言讨论~ 💬

（注：本文测试环境为Qt 6.7 + MySQL 8.0，其他版本可能略有差异）