線上業務突然無法寫入,報錯 #1062 Duplicate entry '2147483647' for key 'PRIMARY'。根因是 INT 類型自增主鍵達到有符號 32 位整數上限 2,147,483,647,後續隱式插入無法獲取合法 ID。本文詳細分析故障機制、重現步驟與多種修復方案。
CREATE TABLE IF NOT EXISTS `test` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`name` varchar(100) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB;
-- 插入「毒藥數據」:顯式指定最大值
INSERT INTO test (id, name) VALUES (2147483647, 'x');
-- 正常插入失敗
INSERT INTO test (name) VALUES ('y');
-- ERROR 1062 (23000): Duplicate entry '2147483647' for key 'PRIMARY'
INT 有符號範圍:-2,147,483,648 ~ 2,147,483,647AUTO_INCREMENT 計數器單調遞增,不回收已用值UNSIGNED INT 上限為 4,294,967,295,僅延緩問題ALTER TABLE test MODIFY COLUMN id BIGINT NOT NULL AUTO_INCREMENT;
-- 上限 9,223,372,036,854,775,807,實際無窮
-- 刪除毒藥數據
DELETE FROM test WHERE id = 2147483647;
-- 重置自增計數器
ALTER TABLE test AUTO_INCREMENT = 1;
-- 或具體值
ALTER TABLE test AUTO_INCREMENT = (SELECT MAX(id)+1 FROM test);
CREATE TABLE test_new LIKE test;
ALTER TABLE test_new MODIFY COLUMN id BIGINT NOT NULL AUTO_INCREMENT;
INSERT INTO test_new SELECT * FROM test;
RENAME TABLE test TO test_old, test_new TO test;
pt-online-schema-change 零鎖遷移BIGINT,納入 SQL 規範檢查SELECT MAX(id)/4294967295 * 100 AS pct FROM table,超 80% 告警INSERT ... VALUES (id, ...) 顯式指定 ID 權限INT(11) 中的 11 僅為顯示寬度,不影響存儲範圍自增 ID 耗盡是「遲來的災難」,早規劃 BIGINT、建監控、禁顯式插入,比事後修復成本低千倍。