// SQLite 错误参考

SQLITE_CONSTRAINT_UNIQUE:唯一约束失败

INSERT 或 UPDATE 会在 UNIQUE 列或唯一索引中重复一个值。消息会列出表和列的名称。

结果代码
SQLITE_CONSTRAINT_UNIQUE
名称
2067
类别
扩展结果代码
错误信息
UNIQUE constraint failed: users.email

它的意思

SQLite 返回 SQLITE_CONSTRAINT_UNIQUE (2067),当一次写入会创建两行值相同的行,而位置在同一个 UNIQUE 约束或唯一索引。错误信息会列出涉及的列,例如 table.column,多列键用逗号分隔。重复的主键会以 SQLITE_CONSTRAINT_PRIMARYKEY 但是使用相同的消息文本。

NULL 不算作重复:唯一列可以包含任意数量的 NULL。

常见原因

  • 插入已经存在的行,例如重新运行导入。
  • 在声明了某列的情况下,两个只在大小写上不同的值 COLLATE NOCASE.
  • 一个 UPDATE 将该列设置为另一行已经有的值。

如何修复它

  1. 找到现有的行。

    SELECT * FROM users WHERE email = '[email protected]';
  2. 请改用 upsert 更新现有行(SQLite 3.24 及更高版本)。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. 或者有意跳过重复项。

    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 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

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