// SQLite 错误参考

SQLITE_RANGE:列索引超出范围

传递给 sqlite3_bind 函数的参数编号,或传递给 sqlite3_column 函数的列编号,超出了有效范围。

结果代码
SQLITE_RANGE
名称
25
类别
主要结果代码
错误信息
column index out of range

它的意思

SQLITE_RANGE (25) 表示语句中不存在这个绑定或列索引。参数编号从 1 开始,最大是 ? 占位符的数量(或最大的 ?NNN)。当你传递的值超过语句中的占位符数量时,语言绑定会报告同样的错误,例如 Python 的 Incorrect number of bindings supplied.

常见原因

  • 绑定了参数 0,或提供的参数个数比语句的多一个。
  • 传入的值列表,其数量与 ? 占位符。
  • 读取的列索引超出了结果列数。
  • 当 ? 位于引号内时,它就是字面上的问号,而不是占位符。

如何修复它

  1. 数一数占位符的个数,并恰好传入同样多的值。绑定索引从 1 开始。

  2. 使用命名参数,以免数错。

    SELECT * FROM users WHERE email = :email AND status = :status;
  3. 永远不要给占位符加引号:写 WHERE name = ?,而不是 WHERE name = '?'.

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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