1. Qt数据库概述：Qt SQL模块介绍、支持的数据库类型与驱动加载机制

各位同学好，我是老张。今天咱们正式开始《Qt数据库操作与集成实战》的第一章。

说实话，数据库这块内容，很多Qt开发者一开始都绕道走。觉得麻烦、觉得用不上。但我在实际项目中碰过太多次壁了——数据存本地文件？性能扛不住。用文本存配置？改起来想哭。后来我老老实实把Qt SQL模块啃了一遍，嗯，真香。

1.1 Qt SQL模块是什么？

Qt SQL模块，说白了就是Qt官方给我们封装好的一套数据库操作接口。它不直接操作数据库，而是通过驱动层去跟各种数据库打交道。

你想想看，如果没有这个模块，你要连MySQL得写MySQL的API，连SQLite得写SQLite的API，换一个数据库就得重写一遍代码。Qt SQL模块帮你把这事儿统一了——你只需要学会一套API，就能操作多种数据库。

这个模块主要包含以下几个核心类：

• QSqlDatabase —— 数据库连接管理，一个连接就是一个数据库会话
• QSqlQuery —— 执行SQL语句，增删改查全靠它
• QSqlRecord —— 操作数据库记录的字段信息
• QSqlTableModel —— 把数据库表映射成模型，配合QTableView直接展示
• QSqlRelationalTableModel —— 支持外键关联的模型，处理多表关系很方便
• QSqlDriver / QSqlDriverCreator —— 驱动相关，一般我们不用直接碰

我个人习惯，项目里最常用的就是QSqlDatabase和QSqlQuery。QSqlTableModel在简单展示场景下很好用，但复杂查询我还是倾向于手写SQL。

1.2 支持的数据库类型

Qt SQL模块支持哪些数据库？我列个表给你看：

数据库	驱动名称	是否默认支持	典型应用场景
SQLite	QSQLITE	✅ 默认支持	本地存储、嵌入式设备、单机应用
MySQL / MariaDB	QMYSQL	❌ 需编译或加载	Web后端、多用户系统、服务端应用
PostgreSQL	QPSQL	❌ 需编译或加载	企业级应用、地理信息系统、高并发场景
Oracle	QOCI	❌ 需编译	大型企业、金融系统
ODBC	QODBC	❌ 需编译	连接SQL Server、Access等
DB2	QDB2	❌ 需编译	IBM生态、大型机系统

看到没？默认只带了SQLite。为什么？因为SQLite是嵌入式数据库，不需要额外安装服务，Qt直接把它编译进库里了。其他数据库都需要你手动装驱动。

我在项目中遇到过最坑的事——客户要求用Oracle，结果驱动编译折腾了两天。后来我学乖了，项目初期就确认好数据库类型，提前把驱动环境搭好。

1.3 驱动加载机制

驱动加载这块，很多初学者容易懵。我当年也是，明明代码写对了，就是连不上数据库。后来才搞明白——驱动没加载成功。

Qt的驱动加载机制，其实就三步：

1. 检查驱动是否可用 —— 用QSqlDatabase::drivers()列出所有可用驱动
2. 加载驱动 —— 创建QSqlDatabase实例时指定驱动名称
3. 建立连接 —— 设置主机、端口、用户名、密码等参数，然后open()

来看一段最基础的代码：

#include <QSqlDatabase>
#include <QSqlError>
#include <QDebug>

// 第一步：查看当前可用的驱动
qDebug() << "可用驱动列表：" << QSqlDatabase::drivers();

// 第二步：加载SQLite驱动
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("mydb.sqlite");

// 第三步：打开连接
if (db.open()) {
    qDebug() << "数据库连接成功！";
} else {
    qDebug() << "连接失败：" << db.lastError().text();
}

这段代码跑起来，如果输出里没有"QSQLITE"，那说明你的Qt安装有问题。正常情况下，SQLite驱动是肯定有的。

那MySQL和PostgreSQL的驱动怎么加载？其实流程一样，但需要额外装驱动库。比如MySQL，你需要把libqsqlmysql.so（Linux）或qsqlmysql.dll（Windows）放到Qt的插件目录下。

我曾经踩过一个坑——Windows上编译MySQL驱动，折腾了一下午。后来发现直接下载Qt官方提供的预编译包就行。嗯，有时候别太执着于自己编译。

驱动加载失败时，最常见的错误信息是：

• "Driver not loaded" —— 驱动没找到，检查插件目录
• "Unable to open database" —— 数据库文件或服务连不上
• "Access denied" —— 用户名密码不对

遇到这些问题，我的排查顺序是：先看QSqlDatabase::drivers()有没有目标驱动，再看插件路径对不对，最后检查数据库服务是否启动。

1.4 知识体系总览

下面这张图，是我画的本章节知识结构。你看一眼，心里就有谱了：

这张图把本章内容串起来了。你记住三个关键词就行：核心类、数据库类型、驱动加载。后面的章节，我们会一个一个深入讲。

好了，第一章就到这里。内容不多，但都是基础中的基础。你把这章吃透了，后面学增删改查、学模型视图，都会轻松很多。

可可精品资料库