qsqlite.dll 是 Qt SQL 模块在 Windows 平台上的 SQLite 数据库驱动插件,通常位于 Qt 安装目录的 plugins/sqldrivers 目录中。它不直接替代 SQLite 引擎,而是充当 Qt 应用程序与 SQLite 数据库之间的桥梁。应用程序通过 QSqlDatabase::addDatabase('QSQLITE') 加载该驱动后,即可使用统一的 Qt SQL API 操作 SQLite 数据库。
其核心功能包括:
如果目标系统中缺少 qsqlite.dll,或该文件版本与 Qt 库不匹配,最直接的表现是 Qt 无法加载 SQLite 驱动。常见错误包括:QSqlDatabase: QSQLITE driver not loaded、Driver not loaded Driver not loaded、Cannot load driver QSQLITE。此时应用即使代码正确,也无法建立 SQLite 连接,所有依赖本地数据库的查询、保存、导入导出、配置持久化等功能都会失效。
影响还可能进一步扩散:
部署 Qt 应用时,应确认 sqldrivers/qsqlite.dll 与 Qt5Sql/Qt6Sql、QtCore、QtGui 等库位数一致、版本兼容,并随安装包一并发布;同时确保运行账户具有插件目录读取权限。若使用 windeployqt,应检查 SQLite 驱动是否被正确复制。