c qt连接数据库连接步骤有哪些？

在C++中使用Qt框架连接数据库是开发桌面应用程序时常见的任务，Qt提供了强大的Qt SQL模块，支持多种数据库（如SQLite、MySQL、PostgreSQL、ODBC等），以下是详细的连接步骤和代码示例，涵盖环境配置、连接建立、数据操作及异常处理。

环境准备与配置

1. 包含必要的头文件：在项目代码中引入Qt SQL模块的头文件，如#include <QSqlDatabase>、#include <QSqlQuery>等。
2. 加载Qt SQL模块：在.pro文件中添加QT += sql，确保编译时链接SQL模块。
3. 安装数据库驱动：根据目标数据库类型，确认Qt已安装对应驱动（如QSQLITE、QMYSQL），可通过QSqlDatabase::drivers()检查可用驱动。

建立数据库连接

创建数据库连接对象

使用QSqlDatabase::addDatabase()方法创建连接，并指定数据库类型（如"QMYSQL"）和连接名称（唯一标识）。

QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); // 使用MySQL驱动
db.setHostName("localhost");     // 数据库主机地址
db.setDatabaseName("test_db");   // 数据库名
db.setUserName("root");          // 用户名
db.setPassword("password");      // 密码
db.setPort(3306);                // 端口号（默认3306）

打开连接

调用open()方法尝试连接，并通过lastError()检查错误：

if (!db.open()) {
    qDebug() << "数据库连接失败:" << db.lastError().text();
    return;
}
qDebug() << "数据库连接成功!";

连接参数配置说明

参数	说明	示例值
setHostName	数据库服务器地址	"127.0.0.1"
setDatabaseName	要连接的数据库实例名	"mydb"
setUserName	数据库用户名	"admin"
setPassword	数据库密码	"123456"
setPort	数据库服务端口	5432（PostgreSQL）
setConnectOptions	高级选项（如超时设置）	"CONNECT_TIMEOUT=5"

执行SQL查询

执行非查询语句（如INSERT/UPDATE/DELETE）

使用QSqlQuery执行SQL语句，并通过numRowsAffected()影响行数：

QSqlQuery query;
query.exec("INSERT INTO users (name, age) VALUES ('Alice', 25)");
if (query.lastError().isValid()) {
    qDebug() << "执行失败:" << query.lastError().text();
} else {
    qDebug() << "插入成功，影响行数:" << query.numRowsAffected();
}

执行查询语句（如SELECT）

遍历查询结果时，使用next()移动记录指针，通过value()获取字段值：

QSqlQuery query("SELECT * FROM users WHERE age > 20");
while (query.next()) {
    QString name = query.value("name").toString(); // 按列名获取
    int age = query.value(1).toInt();             // 按列索引获取
    qDebug() << "姓名:" << name << "年龄:" << age;
}

事务处理与批量操作

为确保数据一致性，使用事务（Transaction）包裹多个操作：

db.transaction(); // 开启事务
QSqlQuery query;
query.exec("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
query.exec("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
if (db.commit()) { // 提交事务
    qDebug() << "事务提交成功";
} else {
    db.rollback(); // 回滚事务
    qDebug() << "事务回滚";
}

关闭连接

操作完成后，关闭连接并释放资源：

db.close();
QSqlDatabase::removeDatabase("连接名称"); // 移除连接

常见问题处理

1. 驱动未加载：若提示"Driver not loaded"，需重新编译Qt或安装对应驱动（如MySQL的libmysqlclient）。
2. 连接超时：通过setConnectOptions("MYSQL_OPT_RECONNECT=1")自动重连，或调整QSqlDatabase::setNumericalPrecisionPolicy()处理精度问题。

---

相关问答FAQs

Q1: 如何判断数据库连接是否有效？
A: 可以通过db.isOpen()检查连接状态，或定期执行简单查询（如SELECT 1）验证连接活性。

if (!db.isOpen() || !db.exec("SELECT 1").next()) {
    qDebug() << "连接已失效，尝试重新连接...";
    db.close();
    db.open();
}

Q2: Qt连接MySQL时中文乱码如何解决？
A: 通常需确保数据库、表、字段字符集为utf8mb4，并在连接字符串中指定编码：

db.setConnectOptions("CLIENT_CHARSET=utf8mb4"); // 或在连接URL中添加