Qt中操作SQLite数据库的核心三步是注册驱动、设置数据库文件路径、调用open()；常见失败原因包括构建版本缺失QSQLITE驱动、路径错误或连接未正确管理，需运行时用QSqlDatabase::drivers()检查驱动可用性。
Qt 里用 QSqlDatabase 操作 SQLite，核心就三步：注册驱动、设路径、调 open()。但“能连上”不等于“能稳定用”，很多问题出在连接没管好、路径没写对、或者驱动压根没加载成功。
QSqlDatabase::addDatabase("QSQLITE") 失败的常见原因
不是所有 Qt 构建都默认带 QSQLITE 驱动，尤其跨平台打包或使用 MinGW/MSVC 混合构建时容易漏掉。
- 运行时检查驱动是否可用：
qDebug() ，如果输出里没有 <code>"QSQLITE"，说明驱动缺失，得确认sqldrivers目录下有qsqlite.dll（Windows）或libqsqlite.so（Linux） - Qt 官方预编译包通常自带，但自己编译 Qt 时若没开
-sql-sqlite，就会丢掉这个驱动 - 部署到客户机器时，别只拷二进制，记得把
sqldrivers文件夹一并带上，并确保应用启动时能从QCoreApplication::applicationDirPath() + "/plugins/sqldrivers"找到它
setDatabaseName() 传相对路径的风险
SQLite 数据库就是一个文件，setDatabaseName() 传的是路径，不是名字。传 "data.db" 看似简单，但实际路径取决于当前工作目录（QDir::currentPath()），而 GUI 应用的工作目录常是安装目录、桌面或 Qt Creator 的项目根目录，极不稳定。
- 务必用绝对路径：
db.setDatabaseName(QDir::toNativeSeparators(QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + "/data.db")); - Windows 下避免路径含中文或空格（虽然 SQLite 支持 UTF-8，但 Qt 的路径解析在旧版本中偶有 decode 失败）
- 首次调用
open()时，如果文件不存在，SQLite 会自动创建；但父目录不存在就会静默失败——得提前QDir().mkpath()
open() 返回 false 但 lastError() 是空字符串？
这是最让人抓狂的情况：db.open() 返回 false，但 db.lastError().text() 居然是空的。本质原因是——你重复调用了 addDatabase()，导致 QSqlDatabase 对象被覆盖或重置。
- 每个连接必须用唯一的名字：
QSqlDatabase::addDatabase("QSQLITE", "myconn1")；不传第二个参数时，默认名是"qt_sql_default_connection"，多处调用会冲突 - 不要在多个函数里各自
addDatabase()后又各自open()，应统一管理单例连接，或用静态局部变量封装 - 检查是否在
open()前忘了调setDatabaseName()—— 这种情况下open()也会失败且无错误文本
连接不能复用，但也不能随便 close()
SQLite 是文件锁模型，close() 会释放文件句柄，但频繁 open/close 在高频操作场景下性能差，还可能触发 SQLITE_BUSY（尤其 Windows 上防病毒软件扫描时）。
- 桌面小工具建议：程序启动时 open 一次，退出前 close 一次；中间所有查询都复用这个连接
- 千万别在子线程里直接用主线程创建的
QSqlDatabase对象——Qt SQL 模块不是线程安全的，每个线程必须有自己的连接实例 - 如果真要多线程写入，启用 WAL 模式：
QSqlQuery(db).exec("PRAGMA journal_mode=WAL");，再配合事务批量提交，比关连接重开高效得多
真正麻烦的从来不是“怎么连”，而是“连上之后谁在什么时候关、关了还能不能立刻重开、换路径重连会不会残留锁”。这些细节不提前想清楚，上线后用户点两下就卡住，查日志还只看到 "Unable to fetch row" 这种模糊提示。
