// SQLite 错误参考

SQLITE_MISUSE:参数错误或其他 API 误用

该程序以未定义的方式调用了 SQLite 函数,例如在语句 finalize 之后继续使用它。这是调用方代码中的一个 bug。

结果代码
SQLITE_MISUSE
名称
21
类别
主要结果代码
错误信息
bad parameter or other API misuse

它的意思

SQLITE_MISUSE (21) 表示应用程序误用了 SQLite API。SQLite 会尝试检测误用,但正如其文档所强调的,检测并无保证,同一个 bug 也可能直接让程序崩溃或损坏内存。任何 SQLITE_MISUSE 都是需要修复的错误,而不是需要处理的情况。

常见原因

  • 把预处理语句用在了 sqlite3_finalize(),或者一个连接在 sqlite3_close().
  • 在没有使用串行化线程模式的情况下,在多个线程间共享一个连接或语句。
  • 调用 sqlite3_step() 在返回错误后不重置语句就再次使用。
  • 传递 NULL 或无效的连接句柄。

如何修复它

  1. 找到返回代码的调用并检查对象的生命周期:prepare、bind、step、reset 或 finalize,并且在 finalize 之后绝不要使用它。

  2. 给每个线程分配专属连接,或以串行模式打开连接,并且不要跨线程共享语句。

  3. 在高级语言绑定中,检查是否有对象在其连接关闭后仍被使用,例如在 close().

相关错误

更多主要结果代码错误

代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。