// SQLite 错误参考
SQLITE_CONSTRAINT_PRIMARYKEY:主键约束失败
INSERT 或 UPDATE 会导致主键值重复。SQLite 的报错仍然显示 UNIQUE constraint failed,并指出键列。
- 结果代码
SQLITE_CONSTRAINT_PRIMARYKEY- 名称
1555- 类别
- 扩展结果代码
它的意思
SQLITE_CONSTRAINT_PRIMARYKEY (1555) 是主键重复时的扩展错误码。消息文本与任何唯一约束冲突相同, UNIQUE constraint failed: table.column,因此扩展代码是程序区分两者的方法。
对于一个 INTEGER PRIMARY KEY 列,你可以省略该值(或传递 NULL),SQLite 会分配下一个 rowid,从而避免大多数冲突。
常见原因
- 插入已存在的显式 ID。
- 在数据库之间复制行并连同其 id,且两边的 id 范围有重叠。
- 在应用中用可能重复的方案生成 id。
如何修复它
-
让 SQLite 分配
INTEGER PRIMARY KEY值,只需省略该列即可。INSERT INTO orders (customer_id, total) VALUES (42, 19.99); SELECT last_insert_rowid();
-
合并数据时,按键列 upsert,或跳过已存在的行。
INSERT INTO orders (id, customer_id, total) SELECT id, customer_id, total FROM other.orders WHERE true ON CONFLICT (id) DO NOTHING;
相关错误
SQLITE_CONSTRAINT_UNIQUEUNIQUE 约束失败SQLITE_MISMATCH数据类型不匹配SQLITE_CONSTRAINT约束失败23505PostgreSQL:重复键违反唯一约束1062MySQL:键的重复条目
更多扩展结果代码错误
SQLITE_ERROR_MISSING_COLLSEQ没有这样的排序规则SQLITE_BUSY_RECOVERY另一个进程正在恢复 WALSQLITE_LOCKED_SHAREDCACHE记录在共享缓存中被锁定SQLITE_CONSTRAINT_CHECKCHECK 约束失败SQLITE_ABORT_ROLLBACK语句因 ROLLBACK 而中止SQLITE_BUSY_SNAPSHOT陈旧读取不能转为写入SQLITE_IOERR_SHORT_READ读取返回的字节数不足SQLITE_CANTOPEN_ISDIR路径是一个目录
代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQLite
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。