Qt怎么连接MySQL数据库-C++-PHP中文网

qt默认不带mysql驱动，qsqldatabase::adddatabase("qmysql")失败因qsqlmysql.dll未置于plugins/sqldrivers目录、缺少libmysql.dll依赖或版本/位数/编译器不匹配，需验证qsqldatabase::drivers()含"qmysql"方可继续。

qt怎么连接mysql数据库

Qt 默认不带 MySQL 驱动，QSqlDatabase::addDatabase("QMYSQL") 会直接失败，报错 QSqlDatabase: QMYSQL driver not loaded —— 这不是你代码写错了，是插件根本没放对位置、或依赖库缺失。

QMYSQL 驱动文件放哪？路径必须严格匹配

Qt 的驱动加载靠插件机制，不是靠 .pro 里加 QT += sql 就能自动出来。关键三要素缺一不可：

qsqlmysql.dll（Windows）或 libqsqlmysql.so（Linux）必须放在 plugins/sqldrivers/ 目录下，且该目录必须在 Qt 运行时能搜到（通常是 Qt 安装目录下的 plugins 子目录，不是你项目目录）
对应的 MySQL 客户端库（libmysql.dll 或 libmysqlclient.so）得让系统能找到：Windows 下推荐直接丢进你的可执行文件（.exe）同级目录；Linux 下确保 LD_LIBRARY_PATH 包含其路径
驱动文件和 Qt 版本、编译器、位数（32/64）、ABI（如 MSVC vs MinGW）必须完全一致。用 Qt 6.5.3 + MSVC2019 编译的程序，不能用 Qt 6.4 + MinGW 编译的 qsqlmysql.dll

验证驱动是否就位：别等运行时才报错

在连接数据库前，先确认驱动已识别。加这段代码跑一下：

#include <qdebug>
#include <qsqldatabase>

qDebug() 
<p>输出里必须有 <code>"QMYSQL"</code>。如果没有，说明插件没加载成功——此时再检查路径、依赖、版本，比在 <code>db.open()</code> 返回 <code>false</code> 后瞎猜快得多。</p>

<h3>MySQL 8.0+ 默认认证方式会导致连接被拒</h3>
<p>MySQL 8.0 默认用 <code>caching_sha2_password</code> 插件认证，而 Qt 自带的 MySQL 驱动（基于较老 lib<a style="color:#f60; text-decoration:underline;" title="mysql" href="https://m.php.cn/zt/15713.html" target="_blank">mysql</a>）不支持。现象是 <code>db.open()</code> 失败，<code>db.lastError().text()</code> 显示类似 <code>Authentication plugin 'caching_sha2_password' cannot be loaded</code>。</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
														src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
													<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
<p>解决办法只有两个，选其一：</p>
<ul>
<li>改用户认证方式（推荐开发环境用）：<br>登录 MySQL 执行：<code>ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;</code>
</li>
<li>升级驱动（生产环境更稳妥）：用 MySQL 官方提供的新版 Connector/C，并自己重新编译 <code>qsqlmysql</code> 插件（需 Qt 源码或 <code>qtbase</code> 模块）</li>
</ul>
<h3>QODBC 是备选方案，但别当成“万能解药”</h3>
<p>用 <code>QODBC</code> 绕过原生驱动问题确实可行，但代价明显：</p>
<ul>
<li>必须额外安装 MySQL ODBC 驱动（如 MySQL Connector/ODBC 8.0），且 ANSI/Unicode 版本要和 Qt 编译方式匹配（MSVC 一般选 Unicode）</li>
<li>
<code>setDatabaseName()</code> 填的是你在 ODBC 数据源管理器里配的 <code>Data Source Name</code>（DSN），不是数据库名；填错就直接 <code>open()</code> 失败，错误信息还很模糊</li>
<li>性能略低，部分高级 SQL 功能（如预处理语句绑定）行为可能和原生驱动不一致</li>
</ul>
<p>它只是兜底手段，不是替代方案。真正稳定可控的路径，还是把 <code>QMYSQL</code> 插件配齐。</p>

<p>最容易被忽略的一点：Qt Creator 调试时运行的是它自己的 Qt 环境（比如 Kit 里指定的 Qt 版本），而你手动双击生成的 <code>.exe</code> 运行时走的是系统 PATH 或当前目录下的 Qt 动态库 —— 两者插件路径可能完全不同。务必在最终打包或部署前，用实际运行方式验证驱动加载状态。</p></qsqldatabase></qdebug>