简介这份资源面向需要在 Qt 5.12.1 的 Android 应用中接入 MySQL 数据库的开发者尤其适合具备一定 Qt 与 NDK 交叉编译基础、希望打通移动端数据存储链路的中高级工程师。内容围绕 MySQL 驱动在 Android 平台的编译与集成展开覆盖依赖安装、驱动交叉编译、Qt 插件创建、打包配置、连接测试及安全与性能优化等关键环节可帮助读者解决默认 Qt 库不含 Android MySQL 支持这一常见痛点。压缩包共 934 个文件约 16.51MB以 h 头文件、txt 说明、c 源码、m4 与 configure 构建脚本、po 与 gmo 本地化文件为主另含 pro 工程文件、so 动态库及 readme、changelog 等文档目录结构完整便于按模块查阅与复用。目前已有 777 人学习下载适合作为跨平台数据库集成的实操参考。1. Qt Android 连 MySQL为什么直连是死路中间层才是活路很多人第一次听到「Qt Android 连 MySQL」这个组合脑子里浮现的画面很直接Qt 写个界面Android 上跑起来代码里QSqlDatabase::addDatabase(QMYSQL)一挂查询就出来了。我当初也是这么想的直到在真机上跑出第一行报错——驱动加载失败因为 Qt for Android 的预编译包里压根没带 MySQL 驱动。这不是配置问题是架构问题。这个标题真正要解决的需求很明确用 Qt 做 Android 端应用数据存在 MySQL 里怎么让两端通起来。适合两类人一是手里已经有 MySQL 数据库、想用 Qt 快速搭一个 Android 客户端的开发者二是正在做 Qt 跨平台项目、需要移动端访问服务端数据的团队。核心结论先摆出来Qt Android 不要直连 MySQL走 HTTP 中间层。下面把这条路从选型到跑通拆开讲。2. 三条技术路线的取舍直连、JDBC 桥、HTTP 中间层2.1 直连 MySQL 为什么在 Android 上走不通Qt 的 SQL 模块通过插件机制加载数据库驱动桌面端编译 Qt 时如果带上 MySQL 客户端库QMYSQL驱动就能用。但 Android 平台是另一回事Qt for Android 的官方预编译包只包含 SQLite 驱动MySQL 驱动需要你自己交叉编译 libmysqlclient 和对应的 Qt 插件还要处理 Android NDK 的 ABI 兼容、OpenSSL 依赖、动态库打包进 APK 的路径问题。这一套下来光是编译环境就能耗掉几天。更关键的是安全问题。MySQL 的连接凭据要硬编码在 APK 里APK 是可以反编译的等于把数据库账号密码直接交给每一个装了应用的人。数据库端口暴露在公网任何拿到凭据的人都能直连操作你的库。这不是「注意一下」能解决的是方案本身就不该这么设计。提示如果你在网上看到有人贴出「Qt Android 直连 MySQL 成功」的代码先确认他是不是在桌面端跑的或者用的是本地局域网内的测试库。真机 公网 生产库这条路走不通。2.2 JDBC 桥接方案的适用边界Android 原生开发里连 MySQL 常见做法是走 JDBC通过mysql-connector-java在 Java 层建立连接。Qt Android 理论上可以借助 JNI 调用 Java 层的 JDBC 代码把查询结果再传回 C。这个方案能跑通但代价是你得同时维护 C 和 Java 两套代码JNI 的类型转换和线程模型容易出问题而且 JDBC 驱动本身在 Android 上也有兼容性坑。最要命的是它依然没有解决凭据暴露和数据库直连的安全问题只是换了个语言来直连。我一般会把这个方案定位成「过渡方案」如果你已经有一个 Java 层的模块在跑 JDBCQt 端只是临时接一下可以用。但如果是新项目不值得为它引入 JNI 的复杂度。2.3 HTTP 中间层我实际项目里用的方案最终落地的方案是Qt Android 端用QNetworkAccessManager发 HTTP 请求服务端用任意语言PHP、Python、Java、Node.js 都行写接口接口层去连 MySQL。这样做的收益是多方面的Android 端不需要任何 MySQL 驱动Qt 的网络模块开箱即用数据库凭据只存在于服务端客户端拿不到接口层可以做鉴权、限流、参数校验安全边界清晰换数据库、改表结构客户端不用重新发版代价是多了一层服务端要维护。但对于任何要上线的应用来说这层本来就该有。下面几章就按这个方案从服务端接口到 Qt 端调用一步步跑通。3. 服务端接口用 PHP 写一个最小可用的 MySQL 查询接口3.1 数据库准备与建表先在 MySQL 里建一个测试库和表。假设你已经装好了 MySQLWindows 上用安装包Linux 上用apt install mysql-server或yum install mysql-server登录后执行-- 创建测试数据库 CREATE DATABASE qt_android_demo DEFAULT CHARACTER SET utf8mb4; -- 切换到该库 USE qt_android_demo; -- 建一张用户表字段类型覆盖常见场景 CREATE TABLE users ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL, age INT DEFAULT 0, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 插入两条测试数据 INSERT INTO users (username, age) VALUES (zhangsan, 25), (lisi, 30);这里几个参数值得说明utf8mb4是为了支持完整的 Unicode包括 emoji比utf8更稳妥DEFAULT 0是给 age 字段设默认值对应热搜里「mysql设置默认值为0」的场景ENGINEInnoDB是事务型引擎生产环境基本都用它。3.2 PHP 接口脚本服务端用 PHP 写一个最简单的查询接口返回 JSON。文件放在 Web 服务器的可访问目录下命名为get_users.php?php // 设置响应类型为 JSON header(Content-Type: application/json; charsetutf-8); // 数据库连接参数 $host 127.0.0.1; $dbname qt_android_demo; $user demo_user; // 不要用 root $pass your_password; // 换成实际密码 try { // 使用 PDO 连接指定字符集 $pdo new PDO(mysql:host$host;dbname$dbname;charsetutf8mb4, $user, $pass); // 让 PDO 在出错时抛异常而不是静默失败 $pdo-setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); // 查询用户列表 $stmt $pdo-query(SELECT id, username, age FROM users ORDER BY id); $rows $stmt-fetchAll(PDO::FETCH_ASSOC); // 返回统一格式的 JSON echo json_encode([code 0, data $rows], JSON_UNESCAPED_UNICODE); } catch (PDOException $e) { // 出错时返回错误码不暴露具体错误信息给客户端 http_response_code(500); echo json_encode([code 1, msg server error]); }逻辑说明PDO 是 PHP 访问 MySQL 的推荐方式支持预处理语句能防 SQL 注入。JSON_UNESCAPED_UNICODE保证中文不被转义成\uXXXX。错误处理里故意不把$e-getMessage()返回给客户端避免泄露数据库结构。参数说明$host用127.0.0.1而不是localhost因为localhost在部分环境下会走 Unix socket对应热搜里error 2002 (HY000): cant connect to local MySQL server through socket那个经典报错。用127.0.0.1强制走 TCP行为更可预期。3.3 验证接口能通在浏览器或命令行里访问这个接口确认返回正常# 用 curl 测试接口 curl -s http://你的服务器地址/get_users.php期望输出类似{code:0,data:[{id:1,username:zhangsan,age:25},{id:2,username:lisi,age:30}]}如果返回 500 或空先看 PHP 错误日志再确认 MySQL 用户权限。常见问题是demo_user没有从127.0.0.1访问的权限需要执行GRANT SELECT ON qt_android_demo.* TO demo_user127.0.0.1 IDENTIFIED BY your_password;然后FLUSH PRIVILEGES;。4. Qt Android 端用 QNetworkAccessManager 调接口并解析 JSON4.1 项目配置与网络权限在 Qt Creator 里新建一个 Qt Quick Application 或 Qt Widgets Application目标平台选 Android。关键配置在.pro文件里QT core gui networknetwork模块必须显式加上否则QNetworkAccessManager用不了。Android 端还需要在AndroidManifest.xml里声明网络权限uses-permission android:nameandroid.permission.INTERNET/Qt Creator 的 Android 构建套件通常会自动生成 Manifest如果没有在项目目录下找到android/AndroidManifest.xml手动加上这一行。另外Android 9 以后默认禁止明文 HTTP如果接口是 HTTP 而非 HTTPS需要在 Manifest 的application标签里加android:usesCleartextTraffictrue。生产环境建议上 HTTPS。4.2 发起请求与解析 JSON 的完整代码下面是一个可复用的网络请求封装放在main.cpp或单独的类里都行#include QCoreApplication #include QNetworkAccessManager #include QNetworkRequest #include QNetworkReply #include QJsonDocument #include QJsonObject #include QJsonArray #include QDebug // 发起 GET 请求并解析返回的 JSON void fetchUsers() { QNetworkAccessManager *manager new QNetworkAccessManager(); // 替换成你的接口地址 QUrl url(http://你的服务器地址/get_users.php); QNetworkRequest request(url); // 设置超时避免网络异常时一直挂起 request.setTransferTimeout(10000); QNetworkReply *reply manager-get(request); // 用信号槽处理异步返回 QObject::connect(reply, QNetworkReply::finished, [reply, manager]() { if (reply-error() ! QNetworkReply::NoError) { qDebug() 请求失败: reply-errorString(); reply-deleteLater(); manager-deleteLater(); return; } // 读取原始字节 QByteArray data reply-readAll(); QJsonParseError parseError; QJsonDocument doc QJsonDocument::fromJson(data, parseError); if (parseError.error ! QJsonParseError::NoError) { qDebug() JSON 解析失败: parseError.errorString(); reply-deleteLater(); manager-deleteLater(); return; } // 解析顶层对象 QJsonObject root doc.object(); if (root.value(code).toInt() ! 0) { qDebug() 接口返回错误; reply-deleteLater(); manager-deleteLater(); return; } // 遍历 data 数组 QJsonArray users root.value(data).toArray(); for (const QJsonValue item : users) { QJsonObject user item.toObject(); qDebug() id: user.value(id).toInt() username: user.value(username).toString() age: user.value(age).toInt(); } reply-deleteLater(); manager-deleteLater(); }); }逻辑说明QNetworkAccessManager的请求是异步的必须用信号槽或 lambda 处理finished信号。setTransferTimeout设置 10 秒超时对应热搜里 Qt 网络请求卡死的场景。JSON 解析分两步先QJsonDocument::fromJson拿到文档再逐层取object和array。deleteLater是 Qt 对象的安全释放方式不能在信号槽里直接delete。参数说明QNetworkRequest::setTransferTimeout在 Qt 5.15 及以上可用如果你用的是更早版本需要自己用QTimer实现超时。接口地址里的 IP 或域名要确保 Android 设备能访问到模拟器访问宿主机一般用10.0.2.2代替127.0.0.1。4.3 在 Android 真机上跑通的检查清单代码写完后从编译到真机运行有几个必查项检查项常见问题处理方式网络权限Manifest 缺 INTERNET 权限补uses-permission明文 HTTPAndroid 9 默认禁止加usesCleartextTraffictrue地址可达用了 127.0.0.1换成服务器实际 IP 或域名防火墙服务端 80 端口未开放检查安全组和 iptables字符编码中文乱码服务端和客户端统一 utf8mb4这张表里的每一项我都在不同项目里踩过。尤其是「地址可达」这条模拟器上跑通不代表真机跑通真机的网络环境和模拟器完全不同。5. 避坑与排查Qt Android 连 MySQL 中间层最常见的 5 个翻车点5.1 现象应用启动就闪退日志里出现cannot mix incompatible Qt library原因APK 里打包了多个版本的 Qt 库或者设备上残留了旧版本。这在热搜里fatal: cannot mix incompatible qt library (version ex50601) with this librar就是典型表现。解决清理构建目录重新执行qmake和make确保QT_VERSION一致。如果设备上装过旧版应用先卸载再装。用adb logcat看完整堆栈确认是哪个库版本冲突。5.2 现象请求一直 pending界面卡住不返回原因QNetworkAccessManager默认没有超时网络不通时会一直等。或者你在主线程里用了同步等待。解决设置setTransferTimeout并且永远不要在 UI 线程里做同步网络请求。所有网络操作走异步信号槽。如果服务端响应慢考虑加 loading 状态提示用户。5.3 现象JSON 解析出来是空但接口在浏览器里正常原因服务端返回的 Content-Type 不是application/json或者返回内容前面有 BOM 头。Qt 的QJsonDocument::fromJson对 BOM 敏感。解决服务端确保header(Content-Type: application/json; charsetutf-8)并且 PHP 文件保存为无 BOM 的 UTF-8。用curl -v看响应头确认。5.4 现象真机上请求失败模拟器正常原因模拟器通过10.0.2.2访问宿主机真机需要走局域网 IP 或公网地址。另外真机的网络权限、代理设置、DNS 都可能不同。解决真机测试时确保手机和服务器在同一网络或者服务器有公网 IP。用手机浏览器先访问接口地址确认网络层通。如果公司网络有代理需要在 Qt 里配置QNetworkProxy。5.5 现象MySQL 连接数暴涨服务端报Too many connections原因每次请求都新建 PDO 连接没有复用。高并发下连接数迅速打满。解决PHP 端可以用持久连接PDO::ATTR_PERSISTENT true但更推荐用连接池方案。如果服务端是 Java用 HikariCPNode.js 用mysql2的连接池。对应热搜里「mysql的数据库连接池」这个点连接池不是可选项是生产环境必选项。6. 进阶把接口层换成 Qt 自己的 HTTP Server以及验证数据一致性的技巧走到这里基础链路已经通了。但如果你不想维护 PHP 环境还有一个进阶玩法用 Qt 自己写一个 HTTP Server跑在服务端机器上直接连 MySQL。Qt 从 5.0 开始就有QHttpServer需要额外模块或者用第三方库如QtWebApp。这样整个技术栈统一在 C 里部署时只需要一个可执行文件。具体做法是在服务端用QSqlDatabase连 MySQL桌面端 Qt 自带 QMYSQL 驱动编译时加上即可然后用QHttpServer暴露 REST 接口。Android 端代码完全不用改还是发 HTTP 请求。这个方案的好处是团队如果只熟悉 Qt不需要额外学 PHP 或 Java。代价是 Qt 的 HTTP Server 生态不如成熟 Web 框架丰富鉴权、限流这些要自己实现。验证数据一致性有个实用技巧在服务端接口里加一个version字段每次数据变更时递增。Android 端缓存上次的 version请求时带上服务端对比后如果没变就返回 304减少数据传输。这在数据量大、变更不频繁的场景下很有效。// Android 端带 version 请求 QUrl url(http://服务器地址/get_users.php?version QString::number(lastVersion));服务端收到 version 后先查当前版本号一致就返回{code:0,data:[],version:lastVersion}客户端跳过解析。这个模式在移动端弱网环境下能明显减少流量和等待时间。我自己在这个方案上最大的教训是一开始总想着「能不能少一层」觉得多一个服务端就多一份运维成本。后来发现那一层不是成本是安全边界和灵活性。数据库直连省下来的那点开发时间在第一次安全审计或者第一次改表结构时就会加倍还回去。希望帮到你。本文还有配套的精品资源点击获取