// SQLite 错误参考

SQLITE_MISMATCH:数据类型不匹配

这是 SQLite 少数对类型严格的地方之一:最常见的是把 rowid 或 INTEGER PRIMARY KEY 列设成了非整数值。

结果代码
SQLITE_MISMATCH
名称
20
类别
主要结果代码
错误信息
datatype mismatch

它的意思

SQLite 通常允许在任何列中存储任何值。 SQLITE_MISMATCH SQLite 只在少数坚持要求类型的情况下返回 (20)。SQLite 文档点名的一个例子是 rowid:表的 rowid,以及声明为 INTEGER PRIMARY KEY (它的别名)的列,必须保存整数。将其设置为文本,如 'abc' 或非整数的实数会失败,错误为 datatype mismatch;允许 NULL,这时会挑选下一个可用的整数。

类型错误出现在 STRICT 这些表的上报方式有所不同,例如 SQLITE_CONSTRAINT_DATATYPE.

常见原因

  • 将非整数值(例如 UUID 字符串)插入到一个 INTEGER PRIMARY KEY 列。
  • 正在更新 rowid 到文本值。
  • 从另一个数据库迁移架构,其中 id 列原为文本类型,却把它声明为 INTEGER PRIMARY KEY 在 SQLite 中。

如何修复它

  1. 将整数(或 NULL,让 SQLite 自动分配)插入到 INTEGER PRIMARY KEY 列。

    INSERT INTO users (id, name) VALUES (NULL, 'Ada');
  2. 如果键确实是文本,请改为将其声明为文本主键。

    CREATE TABLE users (
        id   TEXT PRIMARY KEY,
        name TEXT NOT NULL
    );

安全地复现它

CREATE TABLE t (id INTEGER PRIMARY KEY);
INSERT INTO t VALUES ('abc');   -- Runtime error: datatype mismatch (20)

相关错误

更多主要结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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