SQLite插入时忽略错误怎么设置

在SQLite数据库操作中，插入数据是很常见的操作，但经常会遇到因为主键重复、唯一约束冲突导致插入失败报错的情况，很多开发者会疑惑SQLite插入时忽略错误怎么设置。首先要明确，SQLite没有MySQL里的INSERT IGNORE语法，不过它提供了ON CONFLICT子句，能实现插入时忽略错误或者处理冲突的效果。

SQLite插入冲突的常见场景

在插入数据前，先了解哪些情况会触发插入错误：

• 插入的记录主键值和已有记录重复，违反主键唯一约束
• 插入的字段值违反了表中定义的唯一索引约束
• 插入的字段不满足非空约束且没有默认值

其中前两种是比较常见的需要忽略的冲突场景，下面介绍对应的解决方法。

使用ON CONFLICT DO NOTHING忽略冲突

ON CONFLICT是SQLite处理冲突的核心语法，DO NOTHING策略可以在发生冲突时直接忽略当前插入操作，不报错也不修改已有数据。

基本语法格式如下：

-- 创建测试表，id是主键，name有唯一约束
CREATE TABLE IF NOT EXISTS test_table (
    id INTEGER PRIMARY KEY,
    name TEXT UNIQUE,
    age INTEGER
);

-- 插入一条正常数据
INSERT INTO test_table (id, name, age) VALUES (1, '张三', 20);

-- 插入重复id的数据，使用ON CONFLICT DO NOTHING忽略冲突
INSERT INTO test_table (id, name, age) 
VALUES (1, '李四', 21) 
ON CONFLICT(id) DO NOTHING;

-- 插入重复name的数据，忽略冲突
INSERT INTO test_table (id, name, age) 
VALUES (2, '张三', 22) 
ON CONFLICT(name) DO NOTHING;

上面的语句执行后，第二条和第三条插入操作都不会生效，也不会抛出错误，表中仍然只有最开始插入的(1, '张三', 20)这条记录。

指定冲突目标的方式

ON CONFLICT后面的括号里可以指定具体的冲突目标，有两种常见指定方式：

• 指定具体的列名，比如ON CONFLICT(id)，对应列的唯一约束冲突时会触发策略
• 指定唯一约束的名称，如果创建表时给唯一约束定义了名字，可以直接用约束名

如果不确定具体的冲突目标，也可以使用ON CONFLICT DO NOTHING，不过这种方式会捕获所有冲突，可能不符合预期，建议按需指定目标。

和ON CONFLICT DO UPDATE的区别

除了DO NOTHING，ON CONFLICT还有DO UPDATE策略，发生冲突时会更新已有记录而不是忽略：

-- 插入重复id的数据时，更新age字段
INSERT INTO test_table (id, name, age) 
VALUES (1, '李四', 21) 
ON CONFLICT(id) DO UPDATE SET age = excluded.age;

这里的excluded表示当前要插入的记录，这个语句执行后，id为1的记录的age会被更新为21，而不是忽略插入。

注意事项

• ON CONFLICT语法需要SQLite版本在3.24.0及以上，低版本不支持，使用前可以确认版本
• 如果表有多个唯一约束，需要明确指定要捕获哪个约束的冲突，避免误处理
• 忽略冲突只是不抛出错误，不会影响其他正常的插入操作，同一批插入中无冲突的记录会正常写入

总结来说，SQLite中实现插入忽略错误的核心是ON CONFLICT DO NOTHING语法，根据实际的冲突场景指定对应的目标约束，就能灵活处理插入时的冲突问题，避免程序因为插入报错中断。

SQLiteINSERT IGNOREON CONFLICT数据库插入冲突处理修改时间：2026-05-30 21:21:36