// SQLite 错误参考
SQLITE_CONSTRAINT_UNIQUE:唯一约束失败
INSERT 或 UPDATE 会在 UNIQUE 列或唯一索引中重复一个值。消息会列出表和列的名称。
- 结果代码
SQLITE_CONSTRAINT_UNIQUE- 名称
2067- 类别
- 扩展结果代码
它的意思
SQLite 返回 SQLITE_CONSTRAINT_UNIQUE (2067),当一次写入会创建两行值相同的行,而位置在同一个 UNIQUE 约束或唯一索引。错误信息会列出涉及的列,例如 table.column,多列键用逗号分隔。重复的主键会以 SQLITE_CONSTRAINT_PRIMARYKEY 但是使用相同的消息文本。
NULL 不算作重复:唯一列可以包含任意数量的 NULL。
常见原因
- 插入已经存在的行,例如重新运行导入。
- 在声明了某列的情况下,两个只在大小写上不同的值
COLLATE NOCASE. - 一个
UPDATE将该列设置为另一行已经有的值。
如何修复它
-
找到现有的行。
SELECT * FROM users WHERE email = '[email protected]';
-
请改用 upsert 更新现有行(SQLite 3.24 及更高版本)。
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
或者有意跳过重复项。
INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
安全地复现它
CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x'); -- Runtime error: UNIQUE constraint failed: users.email (19)
问题
INSERT OR REPLACE 与 upsert 有什么区别?
INSERT OR REPLACE 会删除冲突行并插入新行,因此你没有提供的列会被重置,删除触发器和外键动作也可能触发。而带有 ON CONFLICT DO UPDATE 会就地更新现有行。
相关错误
SQLITE_CONSTRAINT_PRIMARYKEY主键约束失败SQLITE_CONSTRAINT约束失败23505PostgreSQL:重复键违反唯一约束1062MySQL:键的重复条目2627SQL Server:违反 PRIMARY KEY 或 UNIQUE KEY2601SQL Server:无法插入重复键行ORA-00001Oracle:违反唯一约束
更多扩展结果代码错误
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 以及你使用的其他数据库。