Qt C++ 集成 SQLite 实现本地数据持久化：从原理到宠物投喂器实战

1. 项目概述与核心需求解析

最近在做一个宠物智能投喂器的数据管理后台，核心需求是把设备上传的各种运行数据持久化存储起来，方便后续分析和查看。设备会上传投喂间隔时间、水温、剩余重量这几个关键参数，我需要一个轻量、可靠且易于集成的本地数据库方案。经过一番对比，最终选择了SQLite，并用Qt的C++框架来实现整个数据层的增删改查功能。这个组合对于嵌入式设备或桌面应用来说非常合适，不需要额外部署数据库服务，一个文件搞定所有数据存储。

如果你也在做类似的需要本地数据存储的C++项目，比如物联网设备数据记录、小型桌面应用的用户数据管理，或者只是想学习如何在Qt里操作数据库，那这篇文章应该能给你提供一套可以直接拿来用的解决方案。我会从为什么选SQLite和Qt开始讲起，然后一步步拆解数据库连接、表设计、每一类操作的代码实现，最后还会分享几个我实际开发中踩过的坑和调试技巧。整个方案代码量不大，但功能完整，你可以直接复制代码块到你的项目里修改使用。

2. 技术选型：为什么是SQLite与Qt？

2.1 SQLite的核心优势与适用场景

在项目初期，我评估过几种本地存储方案，比如纯文件存储、XML/JSON序列化，甚至是更重量级的MySQL嵌入式版本。最后锁定SQLite，主要是看中了它以下几个不可替代的优点，这些优点完美契合了宠物投喂器这类项目的需求。

首先就是零配置和轻量级。SQLite整个数据库就是一个普通的磁盘文件，不需要像MySQL或PostgreSQL那样先安装、配置服务、设置用户权限。对于投喂器这种可能跑在资源有限的嵌入式Linux板子或者直接是Windows/Linux桌面端的应用来说，部署复杂度直接降为零。它的库文件很小，编译进程序后增加的开销几乎可以忽略不计，这对于追求启动速度和内存占用的场景至关重要。

其次是完整的SQL支持与ACID事务。虽然是个轻量级数据库，但SQLite支持绝大部分标准的SQL-92语法，我们熟悉的CREATE,INSERT,SELECT,UPDATE,DELETE语句都能用。更重要的是，它支持ACID（原子性、一致性、隔离性、持久性）事务。这意味着即使在向数据库写入投喂记录时程序突然崩溃，数据也不会处于半截写入的损坏状态，这对于确保设备运行数据的完整性非常关键。你可以用BEGIN TRANSACTION和COMMIT把多条插入语句包起来，要么全部成功，要么全部回滚。

再者是出色的可移植性和广泛的语言绑定。SQLite的数据库文件格式是跨平台的，你在Windows上创建的.db文件，可以直接复制到Linux或macOS上，用同样的代码打开访问。而且几乎所有的编程语言都有成熟的SQLite驱动，我用C++/Qt只是其中一种选择。这种可移植性为未来可能的设备迁移或数据备份分析提供了极大的便利。

最后，单用户访问模式恰恰是优点。很多资料会提到SQLite不支持高并发写，但这对于我们的宠物投喂器项目来说根本不是问题。数据写入方通常只有设备上传服务这一个进程，读取方可能是GUI界面，读写频率都很低。这种单文件、单进程优先的访问模型，反而避免了配置网络和用户权限的麻烦，简化了架构。

2.2 Qt SQL模块的简洁与高效

选定了SQLite作为存储引擎，接下来就是操作它的工具。Qt框架内置的QtSql模块让数据库操作变得异常简单。它提供了一套统一的、面向对象的API来操作不同的数据库（SQLite, MySQL, PostgreSQL等），你不需要去记各种数据库原生C API的晦涩函数。

QSqlDatabase类负责管理数据库连接，QSqlQuery类用来执行任何SQL语句并处理结果，QSqlTableModel或QSqlQueryModel还能方便地将数据库表和Qt的QTableView等视图组件绑定，实现GUI的快速开发。这种抽象层次既屏蔽了底层差异，又保留了足够的灵活性。对于我们的增删改查需求，主要用到前两个类就足够了。

更重要的是，Qt的这套API错误处理很清晰。每个可能失败的操作（如打开数据库、执行查询）都会有一个关联的QSqlError对象，你可以很方便地获取错误描述，这对于调试和构建健壮的程序非常重要。后面在代码实现部分，你会看到我如何利用这一点。

3. 项目环境搭建与数据库设计

3.1 Qt项目配置与SQL模块引入

在开始写代码之前，首先要确保你的Qt项目已经正确配置，能够使用SQL模块。无论你是用Qt Creator新建项目，还是在已有的项目里添加数据库功能，步骤都很简单。

打开你的Qt项目配置文件（通常是.pro文件），在里面添加一行：

QT += sql core

这里的core是默认包含的，写上是为了清晰。这行配置告诉Qt的构建系统（qmake或CMake），你的项目需要链接QtSql模块。保存后，重新执行qmake（在Qt Creator里通常是“构建”->“执行qmake”）并重新构建项目。

接下来，在你需要操作数据库的C++源文件头部，包含必要的头文件：

#include <QSqlDatabase> #include <QSqlQuery> #include <QSqlError> #include <QDebug> // 用于调试输出

QSqlDatabase用于建立连接，QSqlQuery用于执行SQL命令，QSqlError用于获取错误信息，QDebug是我们用来在控制台打印日志的，在实际产品中你可能会换成更正式的日志系统。

3.2 数据库表结构设计与考量

宠物投喂器每次上传的数据包，我设计用一张表来存储。表结构的设计直接影响到后续查询的效率和便利性。这是我的petfeeder表结构：

CREATE TABLE IF NOT EXISTS petfeeder ( id INTEGER PRIMARY KEY AUTOINCREMENT, interval INTEGER NOT NULL, temperature REAL NOT NULL, weight REAL NOT NULL, upload_time DATETIME DEFAULT CURRENT_TIMESTAMP );

我来解释一下每个字段的设计考虑：

1. id (INTEGER PRIMARY KEY AUTOINCREMENT): 这是主键。AUTOINCREMENT关键字保证每条新记录都会自动获得一个唯一且递增的ID。这不仅是良好的数据库实践，便于定位单条记录（比如根据id删除或更新），而且在后续如果需要关联其他表时也很有用。即使当前只有一张表，加上它也是推荐做法。
2. interval (INTEGER NOT NULL): 投喂间隔时间，单位是秒。定义为INTEGER类型，NOT NULL约束确保每条记录这个字段必须有值，避免了数据不完整。
3. temperature (REAL NOT NULL): 水温，单位是摄氏度。SQLite的REAL类型对应C++的double或float，适合存储带小数的温度值。
4. weight (REAL NOT NULL): 剩余重量，单位是千克。同样用REAL类型。
5. upload_time (DATETIME DEFAULT CURRENT_TIMESTAMP): 这是一个我强烈建议添加的字段。它记录了数据插入数据库的服务器时间（即运行此程序的电脑的时间）。DEFAULT CURRENT_TIMESTAMP是SQLite的魔法，它会在你执行INSERT语句时，自动将当前时间戳填入这个字段，你不需要在代码里手动传值。这个时间戳对于数据分析至关重要，比如你可以查询“今天上午10点到12点之间的所有投喂记录”，或者按小时、按天聚合数据。没有时间戳，数据就失去了时序性，价值大打折扣。

注意：这里有一个关键点需要理解。设备上传的数据里可能自带一个“设备时间戳”，但那个时间可能不准（设备时钟未校准或电池耗尽后重置）。而upload_time记录的是数据到达并存入我们数据库的可靠时间。在分析时，你可以根据业务需求决定使用哪个时间。我选择优先相信服务器时间。

4. 核心功能实现：数据库连接与基本操作

4.1 建立与关闭数据库连接

所有数据库操作的第一步都是建立连接。在Qt中，我们使用QSqlDatabase类来管理连接。我习惯将创建连接的逻辑封装成一个函数，这样结构清晰，也便于在程序启动时调用。

bool createConnection() { // 1. 添加一个SQLite类型的数据库连接，连接名可以自定义，这里用默认连接。 QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); // 2. 设置数据库文件路径。这里使用相对路径，数据库文件会生成在程序运行目录下。 db.setDatabaseName("petfeeder.db"); // 3. 尝试打开数据库。如果文件不存在，SQLite会自动创建一个新的空数据库文件。 if (!db.open()) { qDebug() << "Failed to connect database:" << db.lastError().text(); return false; } qDebug() << "Database connected successfully!"; return true; }

关键点解析：

• QSqlDatabase::addDatabase("QSQLITE")：这里的"QSQLITE"是驱动名称，告诉Qt我们要用SQLite。Qt还支持"QMYSQL","QPSQL"等。
• setDatabaseName()：参数可以是绝对路径（如"C:/data/petfeeder.db"）或相对路径。使用相对路径更便于程序移植。如果文件不存在，SQLite会新建它；如果存在，则打开它。
• db.open()：这是可能失败的操作，比如磁盘写保护、路径无权限等。所以必须检查返回值。
• db.lastError().text()：如果打开失败，通过这个方法可以获取到可读的错误描述，对于调试至关重要。

当程序退出，或者确定一段时间不再需要访问数据库时，应该主动关闭连接。虽然程序结束时连接会自动关闭，但显式关闭是好习惯。

void closeConnection() { // 获取我们之前建立的默认数据库连接 QSqlDatabase db = QSqlDatabase::database(); if (db.isOpen()) { db.close(); qDebug() << "Database connection closed."; } }

4.2 创建数据表的稳健策略

连接建立后，第一件事就是确保我们需要的表存在。我们不能假设数据库文件是全新的，也可能是一个已有的、甚至包含旧版本表的文件。因此，创建表的SQL语句应该使用IF NOT EXISTS子句。

bool createTable() { QSqlQuery query; QString sql = "CREATE TABLE IF NOT EXISTS petfeeder (" "id INTEGER PRIMARY KEY AUTOINCREMENT, " "interval INTEGER NOT NULL, " "temperature REAL NOT NULL, " "weight REAL NOT NULL, " "upload_time DATETIME DEFAULT CURRENT_TIMESTAMP)"; if (!query.exec(sql)) { qDebug() << "Failed to create table:" << query.lastError().text(); return false; } qDebug() << "Table checked/created successfully."; return true; }

注意事项：

• SQL字符串的拼接：在C++中拼接长SQL字符串，使用QString的arg()方法或者直接换行拼接都是可以的。确保字符串最终是合法的SQL语法。注意字段定义后面的逗号不要漏掉或多余。
• 错误检查：QSqlQuery::exec()执行任何SQL语句都可能失败（比如语法错误、表已存在但结构冲突等）。务必检查其返回值，并通过query.lastError()获取详细信息。
• 表结构变更：如果项目迭代中需要为已有的表增加字段（比如后期想加一个food_type字段），CREATE TABLE IF NOT EXISTS不会修改现有表。你需要额外处理数据库迁移（Migration），比如写脚本检查表结构版本，然后用ALTER TABLE ADD COLUMN语句。对于小型项目，也可以在程序启动时尝试添加列，并忽略“列已存在”的错误。

5. 数据操作（CRUD）的详细实现与优化

5.1 数据插入（Create）：参数化查询防注入

插入数据是最常用的操作。设备每上传一次数据，我们就执行一次插入。这里有一个极其重要的安全和性能最佳实践：使用参数化查询（Prepared Statement），而不是手动拼接SQL字符串。

错误示范（存在SQL注入风险且效率低）：

// 危险！不要这样做！ void insertDataBad(int interval, double temperature, double weight) { QSqlQuery query; QString sql = QString("INSERT INTO petfeeder (interval, temperature, weight) " "VALUES (%1, %2, %3)").arg(interval).arg(temperature).arg(weight); query.exec(sql); // 如果参数中包含SQL特殊字符，可能导致注入或语法错误。 }

正确做法（参数化查询）：

bool insertData(int interval, double temperature, double weight) { QSqlQuery query; // 使用占位符 ? 来表示参数 QString sql = "INSERT INTO petfeeder (interval, temperature, weight) " "VALUES (?, ?, ?)"; query.prepare(sql); // 准备查询语句 // 按照占位符的顺序绑定实际的值 query.addBindValue(interval); query.addBindValue(temperature); query.addBindValue(weight); if (!query.exec()) { qDebug() << "Failed to insert data:" << query.lastError().text(); return false; } qDebug() << "Data inserted, ID:" << query.lastInsertId().toInt(); // 获取自增ID return true; }

为什么必须用参数化查询？

1. 安全：这是最主要的原因。如果interval、temperature等参数来自不可信的用户输入（比如网络请求），恶意用户可能输入类似0); DROP TABLE petfeeder; --的内容。如果直接拼接，最终SQL会变成INSERT ... VALUES (0); DROP TABLE petfeeder; -- ...)，导致数据被删除。参数化查询将数据和指令分离，数据库引擎会确保传入的值只被当作数据处理，永远不会被解释为SQL指令，从根本上杜绝了SQL注入攻击。
2. 性能：对于需要反复执行相同结构SQL语句的操作（比如批量插入），参数化查询只需编译一次SQL语句，然后每次执行只需绑定新参数即可，数据库引擎可以复用执行计划，显著提升性能。
3. 正确性：自动处理了数据类型转换和特殊字符转义。比如，如果temperature是一个字符串"O'Brien"，直接拼接会导致SQL语法错误，而参数化查询会正确处理。

5.2 数据查询（Read）：灵活筛选与结果遍历

查询功能是我们从数据库读取数据的途径。基础查询是获取所有记录，但更常见的是根据条件筛选。

基础查询（获取所有记录）：

void queryAllData() { QSqlQuery query("SELECT id, interval, temperature, weight, upload_time FROM petfeeder ORDER BY upload_time DESC"); if (!query.isActive()) { // 检查查询是否成功执行 qDebug() << "Query failed:" << query.lastError().text(); return; } while (query.next()) { int id = query.value("id").toInt(); int interval = query.value("interval").toInt(); double temp = query.value("temperature").toDouble(); double weight = query.value("weight").toDouble(); QString uploadTime = query.value("upload_time").toString(); // SQLite存储为字符串 qDebug() << QString("ID:%1, 间隔:%2秒, 水温:%3°C, 重量:%4kg, 时间:%5") .arg(id).arg(interval).arg(temp).arg(weight).arg(uploadTime); } }

• query.next()：用于遍历结果集的每一行。在首次调用前，查询结果指针位于第一行之前。每次调用next()，指针移动到下一行，如果还有数据则返回true，否则返回false。
• query.value()：获取当前行指定列的值。参数可以是列的索引（从0开始），也可以是列的名字字符串（如"id"）。我推荐使用列名，因为代码可读性更好，即使表结构改变（列顺序调整），代码也不容易出错。
• ORDER BY upload_time DESC：按上传时间降序排列，这样最新的记录会显示在最前面，符合大多数查看习惯。

条件查询（带参数化）： 假设我们需要查询水温高于某个阈值，并且剩余重量低于某个阈值的记录，用于预警。

void queryDataWithCondition(double tempThreshold, double weightThreshold) { QSqlQuery query; query.prepare("SELECT * FROM petfeeder WHERE temperature > ? AND weight < ? ORDER BY id"); query.addBindValue(tempThreshold); query.addBindValue(weightThreshold); if (!query.exec()) { qDebug() << "Conditional query failed:" << query.lastError().text(); return; } while (query.next()) { // ... 遍历结果，同上 } }

5.3 数据更新（Update）与删除（Delete）

更新和删除操作通常需要精确定位到某一条或某一批记录，WHERE子句是关键。同样，为了安全和清晰，务必使用参数化查询。

更新指定ID的记录：

bool updateData(int id, int newInterval, double newTemperature, double newWeight) { QSqlQuery query; query.prepare("UPDATE petfeeder SET interval=?, temperature=?, weight=? WHERE id=?"); query.addBindValue(newInterval); query.addBindValue(newTemperature); query.addBindValue(newWeight); query.addBindValue(id); // WHERE条件的值 if (!query.exec()) { qDebug() << "Failed to update data ID" << id << ":" << query.lastError().text(); return false; } // 检查是否真的有行被更新 if (query.numRowsAffected() > 0) { qDebug() << "Data updated successfully for ID:" << id; return true; } else { qDebug() << "No data found with ID:" << id << ". Nothing updated."; return false; // 或者根据业务逻辑，这可能不算错误 } }

• query.numRowsAffected()：返回受上一次UPDATE、DELETE或INSERT操作影响的行数。这对于判断操作是否真的生效非常有用。比如，如果你传了一个不存在的id，这个值会是0。

删除指定ID的记录：

bool deleteData(int id) { QSqlQuery query; query.prepare("DELETE FROM petfeeder WHERE id=?"); query.addBindValue(id); if (!query.exec()) { qDebug() << "Failed to delete data ID" << id << ":" << query.lastError().text(); return false; } if (query.numRowsAffected() > 0) { qDebug() << "Data deleted successfully for ID:" << id; return true; } else { qDebug() << "No data found with ID:" << id << ". Nothing deleted."; return false; } }

关于批量删除：如果需要根据条件批量删除（例如删除所有3天前的记录），可以这样写：

query.prepare("DELETE FROM petfeeder WHERE upload_time < datetime('now', '-3 days')");

这里用到了SQLite的日期时间函数datetime，'now'表示当前时间，'-3 days'表示减去3天。这比在C++里计算时间再传参更简洁。

6. 高级话题与性能优化实践

6.1 使用事务提升批量操作性能

当需要一次性插入大量数据时（比如设备离线一段时间后重新连接，上传历史数据），逐条执行INSERT语句会非常慢，因为每次插入都涉及磁盘I/O和事务日志写入。这时应该使用事务（Transaction）。

事务将一系列数据库操作打包成一个原子单元。在事务内，所有操作要么全部成功，要么全部失败回滚。对于批量插入，使用事务可以带来数十倍甚至上百倍的性能提升。

bool insertBatchData(const QList<FeedingRecord> &records) { QSqlDatabase db = QSqlDatabase::database(); if (!db.transaction()) { // 开始事务 qDebug() << "Failed to start transaction:" << db.lastError().text(); return false; } QSqlQuery query; query.prepare("INSERT INTO petfeeder (interval, temperature, weight) VALUES (?, ?, ?)"); foreach (const FeedingRecord &record, records) { query.addBindValue(record.interval); query.addBindValue(record.temperature); query.addBindValue(record.weight); if (!query.exec()) { qDebug() << "Batch insert failed, rolling back:" << query.lastError().text(); db.rollback(); // 任何一条失败，回滚整个事务 return false; } query.finish(); // 为下一次绑定参数准备查询对象 } if (!db.commit()) { // 提交事务，所有更改永久生效 qDebug() << "Failed to commit transaction:" << db.lastError().text(); db.rollback(); return false; } qDebug() << "Batch insert of" << records.size() << "records successful."; return true; }

关键点：

• db.transaction()：开始一个事务。
• 在循环内执行query.exec()，但错误处理中调用db.rollback()，确保一条失败，全部撤销。
• query.finish()：在QSqlQuery准备（prepare）后，执行（exec）前，绑定值（addBindValue）。执行后，如果想用同一个query对象准备新的语句，需要先调用finish()来重置其状态。在循环中复用同一个query对象比每次都新建一个更高效。
• db.commit()：所有操作成功，提交事务。提交后，数据才真正写入磁盘。

6.2 数据库连接管理策略

在稍微复杂的应用中，你可能需要在多个类或线程中访问数据库。Qt的数据库连接是可以通过名称来区分的。

使用命名连接：

// 在主线程创建默认连接 QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); db.setDatabaseName("petfeeder.db"); // 在另一个模块或线程中，如果你想使用不同的连接（不推荐多线程共享连接，见下文） QSqlDatabase dbWorker = QSqlDatabase::addDatabase("QSQLITE", "worker_connection"); dbWorker.setDatabaseName("petfeeder.db");

之后，你可以通过QSqlDatabase::database("worker_connection")来获取这个特定名称的连接。

关于多线程：SQLite本身在默认配置下不支持多线程同时写入。Qt的SQLite驱动可以在多个线程中打开连接，但每个连接应该只被创建它的线程使用。最佳实践是：

• 在主线程创建和打开数据库连接。
• 如果其他线程需要访问数据库，不要直接共享QSqlDatabase或QSqlQuery对象。它们不是线程安全的。
• 应该在线程内部创建自己的数据库连接（使用不同的连接名），或者通过线程安全的队列将数据库操作请求发送给主线程的一个专门的管理器来执行。

6.3 数据库文件维护与备份

SQLite数据库是一个单独的文件，维护起来相对简单，但也有需要注意的地方。

文件位置与权限：确保应用程序对数据库文件所在目录有读写权限。在Linux嵌入式设备上，这点尤其要注意。建议将数据库文件放在用户数据目录（如QStandardPaths::writableLocation(QStandardPaths::AppDataLocation)）下。

备份：备份SQLite数据库最简单的方式就是直接复制.db文件。但要注意，在复制时，数据库可能正处于写入状态。为了获得一个一致性的备份，可以在复制前执行以下步骤：

1. 在程序中执行BEGIN IMMEDIATE TRANSACTION（通过QSqlQuery）。
2. 复制文件。
3. 执行ROLLBACK或COMMIT。 或者，更简单的方法是使用SQLite的.backup命令（需要通过QSqlQuery执行VACUUM INTO 'backup.db'或使用SQLite的C API）。对于宠物投喂器这种小应用，可以在程序关闭或不进行写操作时（例如深夜）进行备份。

数据库损坏与修复：虽然罕见，但电源故障或磁盘错误可能导致数据库文件损坏。SQLite提供了命令行工具sqlite3来进行修复尝试：

sqlite3 corrupted.db ".recover" | sqlite3 new.db

在程序中，可以定期（比如每月一次）执行PRAGMA integrity_check;语句来检查数据库完整性。如果检查失败，应提示用户并从备份中恢复。

7. 实战中遇到的典型问题与排查技巧

7.1 常见错误与解决方案速查表

7.2 调试与日志记录心得

在开发数据库相关功能时，清晰的日志是快速定位问题的关键。我习惯在每一个数据库操作函数里都加入详细的日志。

启用SQLite的调试输出：你可以在打开数据库连接后，执行以下SQL命令，让SQLite将其所有操作输出到控制台（仅调试时使用）：

QSqlQuery query; query.exec("PRAGMA vdbe_trace = ON;"); // 需要SQLite编译时启用调试支持，不一定可用

更通用的方法是，利用Qt的信号槽机制。QSqlDatabase有一个void committed()信号，但更细粒度的日志需要自己封装。一个简单有效的方法是创建一个包装函数：

bool executeQueryWithLog(QSqlQuery &query, const QString &sql, const QVariantList &params = QVariantList()) { query.prepare(sql); for (const QVariant &param : params) { query.addBindValue(param); } bool success = query.exec(); if (!success) { qCritical() << "[SQL ERROR] Failed to execute query:" << sql; qCritical() << "[SQL ERROR] Parameters:" << params; qCritical() << "[SQL ERROR] Reason:" << query.lastError().text(); } else { qDebug() << "[SQL OK] Executed:" << sql; // 生产环境可关闭此日志 } return success; }

这样，所有SQL错误都会被集中、清晰地记录下来。

检查数据库文件本身：当代码逻辑查不出问题时，不妨直接用图形化工具（如DB Browser for SQLite）打开生成的.db文件，直观地查看表结构、数据内容，甚至直接在里面执行SQL语句进行测试。这能帮你快速区分是代码逻辑问题还是数据本身的问题。

7.3 关于时间戳处理的陷阱

前面提到我添加了upload_time DATETIME DEFAULT CURRENT_TIMESTAMP字段。这里有一个细节：SQLite的DATETIME类型实际上是以TEXT（格式为YYYY-MM-DD HH:MM:SS）、REAL（儒略日）或INTEGER（Unix时间戳）存储的。CURRENT_TIMESTAMP生成的是UTC时间，格式为YYYY-MM-DD HH:MM:SS。

如果你需要存储本地时间，或者在查询时按本地时间过滤，需要小心处理。例如，想查询“今天”的记录：

// 错误：这比较的是UTC时间的‘今天’ query.prepare("SELECT * FROM petfeeder WHERE date(upload_time) = date('now')"); // 更准确的做法：如果需要考虑本地时区，可以使用本地时间函数（但SQLite内置函数有限） // 一种常见做法是在存入时，用C++代码生成本地时间字符串存进去 QString currentTime = QDateTime::currentDateTime().toString("yyyy-MM-dd HH:mm:ss"); query.prepare("INSERT INTO petfeeder (..., upload_time) VALUES (..., ?)"); query.addBindValue(currentTime); // 然后查询时也基于这个字符串日期 QString today = QDate::currentDate().toString("yyyy-MM-dd"); query.prepare("SELECT * FROM petfeeder WHERE upload_time LIKE ? || '%'"); query.addBindValue(today);

对于时间处理要求高的应用，我建议统一用**Unix时间戳（整数）**存储。使用QDateTime::currentSecsSinceEpoch()获取秒级时间戳存入INTEGER字段。查询和显示时再转换回QDateTime。这样计算和比较都非常简单，且与时区无关。

8. 一个完整的示例程序框架

最后，我将上面提到的关键点整合成一个更健壮、更贴近实际项目的示例main.cpp框架。这个框架包含了错误处理、资源清理和基本的使用流程。

#include <QCoreApplication> // 如果是GUI程序则用QApplication #include <QSqlDatabase> #include <QSqlQuery> #include <QSqlError> #include <QDebug> #include <QDateTime> // 定义一个结构体来表示一条投喂记录 struct FeedingRecord { int id; int interval; double temperature; double weight; QString uploadTime; }; bool initDatabase() { QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); // 将数据库放在用户数据目录，更规范 QString dbPath = QStandardPaths::writableLocation(QStandardPaths::AppDataLocation); QDir dir(dbPath); if (!dir.exists()) dir.mkpath("."); db.setDatabaseName(dir.filePath("petfeeder.db")); if (!db.open()) { qCritical() << "Cannot open database:" << db.lastError().text(); return false; } // 启用外键约束（如果未来有多表关联） QSqlQuery query; if (!query.exec("PRAGMA foreign_keys = ON;")) { qWarning() << "Failed to enable foreign keys:" << query.lastError().text(); } // 创建表 QString createTableSQL = "CREATE TABLE IF NOT EXISTS petfeeder (" "id INTEGER PRIMARY KEY AUTOINCREMENT, " "interval INTEGER NOT NULL, " "temperature REAL NOT NULL, " "weight REAL NOT NULL, " "upload_time DATETIME DEFAULT CURRENT_TIMESTAMP)"; if (!query.exec(createTableSQL)) { qCritical() << "Failed to create table:" << query.lastError().text(); return false; } return true; } bool insertFeedingRecord(int interval, double temperature, double weight) { QSqlQuery query; query.prepare("INSERT INTO petfeeder (interval, temperature, weight) VALUES (?, ?, ?)"); query.addBindValue(interval); query.addBindValue(temperature); query.addBindValue(weight); if (!query.exec()) { qCritical() << "Insert failed:" << query.lastError().text(); return false; } qDebug() << "Record inserted, ID:" << query.lastInsertId().toInt(); return true; } QList<FeedingRecord> queryRecentRecords(int limit = 10) { QList<FeedingRecord> records; QSqlQuery query; query.prepare("SELECT * FROM petfeeder ORDER BY upload_time DESC LIMIT ?"); query.addBindValue(limit); if (!query.exec()) { qCritical() << "Query failed:" << query.lastError().text(); return records; } while (query.next()) { FeedingRecord record; record.id = query.value("id").toInt(); record.interval = query.value("interval").toInt(); record.temperature = query.value("temperature").toDouble(); record.weight = query.value("weight").toDouble(); record.uploadTime = query.value("upload_time").toString(); records.append(record); } return records; } int main(int argc, char *argv[]) { QCoreApplication app(argc, argv); // GUI程序改为QApplication // 1. 初始化数据库 if (!initDatabase()) { qCritical() << "Database initialization failed. Exiting."; return -1; } // 2. 模拟插入一些数据 insertFeedingRecord(5, 26.5, 0.8); insertFeedingRecord(3, 25.0, 0.6); insertFeedingRecord(4, 27.0, 0.5); // 3. 查询并打印最近记录 qDebug() << "--- Recent Feeding Records ---"; QList<FeedingRecord> recent = queryRecentRecords(5); for (const FeedingRecord &record : recent) { qDebug() << QString("ID:%1 | 间隔:%2秒 | 水温:%3°C | 重量:%4kg | 时间:%5") .arg(record.id).arg(record.interval) .arg(record.temperature, 0, 'f', 1) // 格式化浮点数，保留1位小数 .arg(record.weight, 0, 'f', 2) .arg(record.uploadTime); } // 4. 程序退出前，Qt会自动关闭数据库连接，但显式关闭是好习惯 QSqlDatabase::database().close(); // 如果是GUI程序，这里应该是 return app.exec(); return 0; }

这个框架展示了从初始化、插入、查询到关闭的完整生命周期。你可以以此为基础，扩展出更复杂的业务逻辑，比如定时清理旧数据、数据导出、图表展示等。记住，良好的错误处理、资源管理和日志记录，是构建稳定可靠的数据持久层的基础。