// SQLite 错误参考

SQLITE_CONSTRAINT_PRIMARYKEY:主键约束失败

INSERT 或 UPDATE 会导致主键值重复。SQLite 的报错仍然显示 UNIQUE constraint failed,并指出键列。

结果代码
SQLITE_CONSTRAINT_PRIMARYKEY
名称
1555
类别
扩展结果代码
错误信息
UNIQUE constraint failed: orders.id

它的意思

SQLITE_CONSTRAINT_PRIMARYKEY (1555) 是主键重复时的扩展错误码。消息文本与任何唯一约束冲突相同, UNIQUE constraint failed: table.column,因此扩展代码是程序区分两者的方法。

对于一个 INTEGER PRIMARY KEY 列,你可以省略该值(或传递 NULL),SQLite 会分配下一个 rowid,从而避免大多数冲突。

常见原因

  • 插入已存在的显式 ID。
  • 在数据库之间复制行并连同其 id,且两边的 id 范围有重叠。
  • 在应用中用可能重复的方案生成 id。

如何修复它

  1. 让 SQLite 分配 INTEGER PRIMARY KEY 值,只需省略该列即可。

    INSERT INTO orders (customer_id, total) VALUES (42, 19.99);
    SELECT last_insert_rowid();
  2. 合并数据时,按键列 upsert,或跳过已存在的行。

    INSERT INTO orders (id, customer_id, total)
    SELECT id, customer_id, total FROM other.orders WHERE true
    ON CONFLICT (id) DO NOTHING;

相关错误

更多扩展结果代码错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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