“key 1”指表中第一个唯一性索引(按SHOW CREATE TABLE定义顺序),未必是主键;例如先定义UNIQUE KEY uk_email(email)再定义PRIMARY KEY(id),则key 1对应uk_email,冲突值'email=admin'即触发Duplicate entry 'admin' for key 1。

这是唯一性约束被违反的明确信号,不是bug,而是MySQL在严格执行主键或唯一索引定义。
报错信息里“key 1”到底指哪个索引
错误中出现的 for key 'PRIMARY' 或 for key 1 并非固定指向主键——它表示表中“第一个唯一性索引”,顺序由 SHOW CREATE TABLE 输出中索引定义的先后决定。比如:
- 如果建表时先定义了
UNIQUE KEY uk_email(email),再定义PRIMARY KEY (id),那key 1就是uk_email,不是主键 -
Duplicate entry 'admin' for key 1很可能意味着email = 'admin'冲突,而非id重复 - 务必用
SHOW CREATE TABLE table_name确认索引定义顺序和名称,别凭经验猜
INSERT IGNORE为什么有时“没反应”还查不到数据
INSERT IGNORE 表面静默,实际只对主键/唯一索引冲突生效,其他错误照常报出——但某些客户端或驱动会吞掉这些报错,让你误以为“成功跳过”。常见陷阱包括:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 字段类型不匹配(如向
INT插入'abc')在严格模式下仍报ERROR 1366,IGNORE完全不拦截 - 字符串超长(
VARCHAR(10)插入 15 字符)触发ERROR 1406,同样不会被忽略 - 表没建任何
UNIQUE或PRIMARY KEY,INSERT IGNORE和普通INSERT行为完全一致 - 执行后
ROW_COUNT()返回 0,不一定代表被忽略——也可能是上述非唯一性错误导致整条语句失败
复合唯一索引冲突容易被漏看
当唯一约束是多列组合(如 UNIQUE KEY uk_user_action(user_id, action_type, created_date))时,单看某一个字段毫无意义。冲突只发生在整组值完全相同时:
-
(1001, 'login', '2026-11-04')和(1001, 'login', '2026-11-04')→ 冲突 -
(1001, 'login', '2026-11-04')和(1001, 'logout', '2026-11-04')→ 不冲突 -
(1001, 'login', '2026-11-04')和(1001, 'login', NULL)→ 多数版本认为不冲突(NULL 不参与唯一性比较),但旧版本或特殊配置下行为可能不同 - 排查时必须用
SELECT * FROM t WHERE user_id = ? AND action_type = ? AND created_date = ?,不能只查其中一列
自增主键失效是隐藏最深的元凶
看起来是“重复插入”,根源却常在 AUTO_INCREMENT 值异常。典型场景:
- 手动执行
ALTER TABLE t AUTO_INCREMENT = 1,重置后新插入 ID 又从 1 开始 - 批量导入前未检查源数据最大 ID,直接设
AUTO_INCREMENT为 100,但表里已有 ID=200 的记录 - 使用
MyISAM引擎时,崩溃后自增值未持久化,重启后回退 - 查当前状态必须用
SHOW TABLE STATUS LIKE 't',重点关注Auto_increment和Rows两个字段是否合理
真正麻烦的不是报错本身,而是错误信息里那个看似明确的值——它只告诉你“这个值冲突了”,但从不告诉你“为什么这个值会再次出现”。查 SHOW CREATE TABLE、核对 AUTO_INCREMENT、验证复合索引的完整条件,这三步跳过任何一步,都可能让问题反复发生。

















