// SQLite 错误参考
SQLITE_MISUSE:参数错误或其他 API 误用
该程序以未定义的方式调用了 SQLite 函数,例如在语句 finalize 之后继续使用它。这是调用方代码中的一个 bug。
- 结果代码
SQLITE_MISUSE- 名称
21- 类别
- 主要结果代码
它的意思
SQLITE_MISUSE (21) 表示应用程序误用了 SQLite API。SQLite 会尝试检测误用,但正如其文档所强调的,检测并无保证,同一个 bug 也可能直接让程序崩溃或损坏内存。任何 SQLITE_MISUSE 都是需要修复的错误,而不是需要处理的情况。
常见原因
- 把预处理语句用在了
sqlite3_finalize(),或者一个连接在sqlite3_close(). - 在没有使用串行化线程模式的情况下,在多个线程间共享一个连接或语句。
- 调用
sqlite3_step()在返回错误后不重置语句就再次使用。 - 传递 NULL 或无效的连接句柄。
如何修复它
-
找到返回代码的调用并检查对象的生命周期:prepare、bind、step、reset 或 finalize,并且在 finalize 之后绝不要使用它。
-
给每个线程分配专属连接,或以串行模式打开连接,并且不要跨线程共享语句。
-
在高级语言绑定中,检查是否有对象在其连接关闭后仍被使用,例如在
close().
相关错误
更多主要结果代码错误
SQLITE_ERRORSQL 逻辑错误SQLITE_PERM访问权限被拒绝SQLITE_ABORT查询已中止SQLITE_BUSY数据库已锁定SQLITE_LOCKED数据库表被锁定SQLITE_NOMEM内存不足SQLITE_READONLY尝试写入只读数据库SQLITE_INTERRUPT已中断
代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQLite
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。