Duplicate entry 'xxx' for key 'PRIMARY' 或 for key 3 是 MySQL 寫入失敗的高頻錯誤。本文系統分析三大根因:主鍵/唯一鍵值衝突、自增計數器異常、自增值耗盡,並提供排查步驟與解決方案。
ERROR 1062 (23000): Duplicate entry 'value' for key 'key_name'
key_name = 'PRIMARY':主鍵衝突key_name = 'uk_xxx':唯一索引衝突key_name = '3':第 3 個索引(含主鍵)衝突,用 SHOW INDEX FROM tbl 確認對應索引INSERT IGNORE、ON DUPLICATE KEY UPDATE、REPLACE INTO表有自增主鍵 id,當前最大值 54,但 AUTO_INCREMENT=54(應為 55),下次插入嘗試用 54 衝突。
auto_increment 標識)AUTO_INCREMENT 值AUTO_INCREMENT ≤ 最大值,即為原因-- 設置為 最大值 + 1
ALTER TABLE table_name AUTO_INCREMENT = 55;
或在 phpMyAdmin「操作」頁直接修改 AUTO_INCREMENT 輸入框執行。
INSERT 指定了大 ID,後續自增未跟進TRUNCATE TABLE 重置自增,但手動插入舊 IDmysqldump 導入不含 AUTO_INCREMENT 值| 類型 | 有符號上限 | 無符號上限 | 建議用途 |
|---|---|---|---|
TINYINT | 127 | 255 | 極小枚舉/狀態 |
SMALLINT | 32,767 | 65,535 | 小型字典表 |
MEDIUMINT | 8,388,607 | 16,777,215 | 中型業務表 |
INT | 2,147,483,647 | 4,294,967,295 | **通用推薦** |
BIGINT | 9.22e18 | 1.84e19 | 超大表/分布式 ID |
案例:MEDIUMINT UNSIGNED 上限 16,777,215,業務增長超出導致無法插入。
ALTER TABLE t MODIFY id BIGINT UNSIGNED AUTO_INCREMENT;(大表需 pt-osc/gh-ost)(AUTO_INCREMENT - 1) / MAX_UNSIGNED_VALUE * 100%,閾值 80% 告警MAX(id) 差值:差值 > 1000 時告警INT UNSIGNED 翻倍容量SELECT
TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME, DATA_TYPE, COLUMN_TYPE,
AUTO_INCREMENT,
CASE DATA_TYPE
WHEN 'tinyint' THEN 255
WHEN 'smallint' THEN 65535
WHEN 'mediumint' THEN 16777215
WHEN 'int' THEN 4294967295
WHEN 'bigint' THEN 18446744073709551615
END AS max_unsigned,
ROUND(AUTO_INCREMENT /
CASE DATA_TYPE
WHEN 'tinyint' THEN 255
WHEN 'smallint' THEN 65535
WHEN 'mediumint' THEN 16777215
WHEN 'int' THEN 4294967295
WHEN 'bigint' THEN 18446744073709551615
END * 100, 2) AS pct_used
FROM INFORMATION_SCHEMA.COLUMNS
WHERE EXTRA = 'auto_increment'
AND TABLE_SCHEMA NOT IN ('mysql','information_schema','performance_schema','sys')
AND AUTO_INCREMENT IS NOT NULL
ORDER BY pct_used DESC;
建立完善的自增監控與冪等寫入模式,能從根源上消除 Duplicate entry 導致的業務中斷與數據不一致風險。