Ubuntu 10.10下Qt连接MySQL数据库
《Ubuntu 10.10下Qt连接MySQL数据库》
在Linux开发环境中，Qt框架因其跨平台特性和丰富的功能库被广泛应用于图形界面开发。当需要与MySQL数据库交互时，开发者需掌握Qt提供的数据库模块（Qt SQL）的配置与使用方法。本文以Ubuntu 10.10系统为平台，详细介绍如何通过Qt连接MySQL数据库，涵盖环境配置、驱动安装、代码实现及常见问题解决。
一、环境准备
1.1 系统与软件版本
Ubuntu 10.10（Maverick Meerkat）作为基础操作系统，需确保已安装以下组件：
- Qt 4.7.x（通过apt安装或源码编译）
- MySQL Server 5.1.x
- MySQL Client开发包（libmysqlclient-dev）
1.2 安装MySQL
通过终端执行以下命令安装MySQL服务端与客户端：
sudo apt-get update
sudo apt-get install mysql-server libmysqlclient-dev
安装过程中需设置root用户密码，后续配置需使用该密码。
1.3 验证MySQL服务状态
sudo service mysql status
# 若未运行，执行启动命令
sudo service mysql start
二、Qt SQL模块配置
2.1 Qt SQL模块概述
Qt SQL模块提供统一的数据库接口，支持多种数据库驱动（如QMYSQL、QPSQL、QSQLITE）。连接MySQL需使用QMYSQL驱动，该驱动依赖MySQL客户端库。
2.2 检查Qt支持的驱动
在Qt程序中添加以下代码检查可用驱动：
#include
#include
int main() {
qDebug() 若输出中未包含"QMYSQL"，需手动编译或安装驱动。
2.3 手动编译QMYSQL驱动（可选）
若系统未提供预编译驱动，需从Qt源码编译：
- 下载对应版本的Qt源码包（如qt-everywhere-opensource-src-4.7.4.tar.gz）
- 解压后进入src/plugins/sqldrivers/mysql目录
- 执行qmake生成Makefile：
qmake "INCLUDEPATH+=/usr/include/mysql" "LIBS+=-L/usr/lib/mysql -lmysqlclient" mysql.pro
make
sudo make install
编译完成后，驱动文件（libqsqlmysql.so）将安装至Qt的plugins/sqldrivers目录。
三、Qt连接MySQL代码实现
3.1 基本连接流程
连接MySQL需完成以下步骤：
- 创建QSqlDatabase对象
- 设置连接参数（主机名、数据库名、用户名、密码）
- 打开数据库连接
- 执行SQL查询
- 关闭连接
3.2 示例代码
#include
#include
#include
#include
#include
int main(int argc, char *argv[]) {
QCoreApplication a(argc, argv);
// 创建数据库连接
QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
db.setHostName("localhost"); // 数据库主机
db.setDatabaseName("testdb"); // 数据库名
db.setUserName("root"); // 用户名
db.setPassword("yourpassword");// 密码
// 尝试连接
if (!db.open()) {
qDebug() 3.3 代码说明
-
QSqlDatabase::addDatabase()：添加数据库驱动，参数为驱动名称（QMYSQL） -
setHostName()：设置数据库服务器地址，本地使用"localhost" -
exec()：执行SQL语句，返回bool值表示成功与否 -
lastError()：获取错误信息
四、常见问题与解决方案
4.1 驱动未加载错误
现象：程序报错"QSqlDatabase: QMYSQL driver not loaded"
原因：
- 未安装libmysqlclient-dev
- QMYSQL驱动未正确编译或安装
- 动态库路径未包含驱动文件
解决：
- 确认安装开发包：
sudo apt-get install libmysqlclient-dev - 检查驱动文件是否存在：
ls /usr/lib/qt4/plugins/sqldrivers/libqsqlmysql.so - 设置动态库路径：
export LD_LIBRARY_PATH=/usr/lib/qt4/plugins/sqldrivers:$LD_LIBRARY_PATH
4.2 连接拒绝错误
现象：报错"Can't connect to MySQL server on 'localhost'"
原因：
- MySQL服务未运行
- 用户名或密码错误
- 防火墙阻止连接
解决：
- 启动MySQL服务：
sudo service mysql start - 验证密码：
mysql -u root -p - 检查防火墙规则：
sudo ufw status
4.3 权限不足错误
现象：报错"Access denied for user 'root'@'localhost'"
原因：MySQL用户未授权访问指定数据库
解决：
- 登录MySQL后执行授权命令：
GRANT ALL PRIVILEGES ON testdb.* TO 'root'@'localhost' IDENTIFIED BY 'yourpassword';
FLUSH PRIVILEGES;
五、性能优化建议
5.1 连接池管理
频繁创建和关闭数据库连接会影响性能，建议使用连接池：
// 示例：复用全局连接
QSqlDatabase& getDatabaseConnection() {
static QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL", "unique_connection_name");
if (!db.isOpen()) {
db.setHostName("localhost");
db.setDatabaseName("testdb");
db.setUserName("root");
db.setPassword("yourpassword");
db.open();
}
return db;
}
5.2 预处理语句
使用QSqlQuery::prepare()和bindValue()防止SQL注入并提高重复查询效率：
QSqlQuery query;
query.prepare("INSERT INTO users (name, age) VALUES (:name, :age)");
query.bindValue(":name", "Charlie");
query.bindValue(":age", 28);
query.exec();
六、总结
在Ubuntu 10.10下使用Qt连接MySQL数据库需完成环境配置、驱动安装和代码编写三部分工作。关键步骤包括安装MySQL服务端与客户端开发包、验证Qt SQL驱动可用性、编写连接与查询代码，以及处理常见错误。通过合理使用连接池和预处理语句，可进一步提升应用性能。
关键词：Ubuntu 10.10、Qt、MySQL数据库、QMYSQL驱动、SQL查询、连接池、预处理语句
简介：本文详细介绍在Ubuntu 10.10系统下使用Qt框架连接MySQL数据库的全过程，包括环境配置、驱动安装、代码实现及常见问题解决，涵盖连接管理、SQL操作和性能优化技巧。
