// SQLite 错误参考

SQLITE_ERROR: SQL 逻辑错误

SQLite 的通用错误代码:语法错误、缺少表或列,或 SQL 的其他问题。真正的原因在错误消息中,而不是代码中。

结果代码
SQLITE_ERROR
名称
1
类别
主要结果代码
错误信息
SQL logic error

它的意思

SQLITE_ERROR (1) 是 SQLite 在没有更具体的错误码适用时使用的代码。SQL 本身出的错几乎都会落到这里:拼写错误、表或列不存在、表已存在、值的数量不对。通用文本是 SQL logic error;消息来自 sqlite3_errmsg() 说明实际出了什么问题,例如 no such table: users, no such column: emial, near "FORM": syntax error 或者 table users already exists.

由于一个错误代码可能对应很多种问题,请务必记录并阅读消息内容。

常见原因

  • 语法错误: near "...": syntax error 指向解析失败所在的那个标记。
  • no such table:表名拼写错了;它存在于某个你没加限定的附加数据库里;或者程序打开的数据库文件与你以为的不是同一个(通常是新建的空文件)。
  • no such column: 列名拼写错误,或者是一个被 SQLite 当成列名的双引号字符串字面量。
  • table ... already exists 来自一个 CREATE TABLE 无 IF NOT EXISTS.
  • 使用了 SQLite 版本因太旧而无法支持的语法或函数,例如 RETURNING (3.35) 或窗口函数 (3.25)。

如何修复它

  1. 阅读完整消息并修复其指出的问题。检查你实际连接的模式:

    SELECT name, type FROM sqlite_schema ORDER BY name;
    PRAGMA table_info(users);
  2. 如果表丢失,请检查哪个文件已打开。相对路径会相对于进程的工作目录打开文件,而打开不存在的路径会创建一个新的空数据库。

    PRAGMA database_list;
  3. 字符串字面量使用单引号,双引号仅用于标识符。

    SELECT * FROM users WHERE status = 'active';
  4. 如果新语法执行失败,请检查库的版本。

    SELECT sqlite_version();

安全地复现它

SELECT * FROM no_such_table;   -- Parse error: no such table: no_such_table

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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