INSERT IGNORE是MySQL特有语法,仅在存在PRIMARY KEY或UNIQUE索引时对冲突行静默跳过、不报错不更新,无索引则等同普通INSERT;它不处理NOT NULL等其他错误,也不支持更新,语义上仅为“存在即丢弃”。

MySQL 的 INSERT IGNORE 是什么行为
INSERT IGNORE 不是标准 SQL,而是 MySQL 特有的语法。它会让 MySQL 在遇到主键(PRIMARY KEY)或唯一索引(UNIQUE KEY)冲突时,跳过当前行插入,不报错,继续执行后续语句。它不会更新已有数据,也不会回滚整个语句(除非在事务中且遇到其他错误)。
- 仅对违反
PRIMARY KEY或UNIQUE约束的行生效 - 对
NOT NULL、CHECK、外键等其他约束失败,仍会报错 - 如果表没有定义任何唯一性约束,
INSERT IGNORE和普通INSERT行为完全一致
怎么写一个安全的 INSERT IGNORE 语句
确保它真能“忽略”重复,关键在表结构和语句写法:
- 必须提前在目标列上建立
PRIMARY KEY或UNIQUE索引(例如:email列设为UNIQUE) - 插入语句中要包含足以触发该约束的字段(比如按
email去重,就一定要提供email值) - 不要依赖隐式转换:如
email是VARCHAR(255),但插入'user@ex.com '(带空格),可能因末尾空格被截断而意外匹配,建议提前TRIM()处理
示例:
INSERT IGNORE INTO users (id, email, name) VALUES (101, 'a@b.com', 'Alice');如果
id 或 email 已存在,这一行被静默跳过。
INSERT IGNORE 和 INSERT ... ON DUPLICATE KEY UPDATE 的区别
两者都处理重复,但行为完全不同:
-
INSERT IGNORE:冲突 → 跳过整行,不做任何修改 -
INSERT ... ON DUPLICATE KEY UPDATE:冲突 → 执行UPDATE子句,可更新部分字段(比如更新updated_at)
常见误用场景:想“有则更新、无则插入”,却用了 IGNORE,结果数据没更新也不报错,还以为成功了。
- 如果需要幂等写入 + 更新时间戳,必须用
ON DUPLICATE KEY UPDATE updated_at = NOW() -
INSERT IGNORE无法获取“本次是否实际插入”的反馈,而ON DUPLICATE KEY UPDATE可通过ROW_COUNT()区分(返回 1=插入,2=更新)
PostgreSQL 或 SQLite 用户别直接抄 INSERT IGNORE
MySQL 的 INSERT IGNORE 在其他数据库里不通用:
- PostgreSQL:用
INSERT ... ON CONFLICT DO NOTHING(需指定冲突目标,如ON CONFLICT (email) DO NOTHING) - SQLite:支持
INSERT OR IGNORE INTO ...,行为最接近 MySQL,但同样要求有UNIQUE或PRIMARY KEY - SQL Server:没有直接对应语法,得用
MERGE或先IF NOT EXISTS判断
跨数据库迁移时,最容易漏掉的就是这个语法差异——看着 SQL 没报错,实际重复数据全被吞了,还查不出原因。
真正起作用的从来不是关键字本身,而是背后那个唯一索引是否存在、是否覆盖了你认为“应该去重”的字段。

















