MySQL 錯誤 1062:鍵值重複
INSERT 或 UPDATE 試圖把已存在的值放進 PRIMARY KEY 或 UNIQUE 索引。訊息會指出該值與索引鍵。
- 錯誤號碼
1062- 名稱
ER_DUP_ENTRY- SQLSTATE
23000- 類別
- 鍵與約束
它的意義
當資料列在主鍵或唯一索引上的值與既有資料列相同時,MySQL 會拒絕該資料列。訊息會顯示重複的值與索引,例如 Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 以上版本會在鍵中包含資料表名稱)。
搭配多列 INSERT,重複資料之前的資料列在非交易型資料表(如 MyISAM)上會保留,但用 InnoDB 時整個語句會回滾。
常見原因
- 重新執行匯入或 seed 腳本,插入已經存在的資料列。
- 插入已存在的明確 ID,或
AUTO_INCREMENT計數器原本被設得低於目前最大值。 - 一個
UPDATE將唯一欄位更改為另一列已有的值。 - 在不區分大小寫定序的欄位上建唯一索引:
[email protected]和[email protected]算作相同的值。
如何修正
-
檢視已經持有該值的資料列。
SELECT * FROM users WHERE email = '[email protected]';
-
若要改為更新現有資料列,請使用
INSERT ... ON DUPLICATE KEY UPDATE。在 MySQL 8.0.19 之後的版本,請透過資料列別名來參照新值;更舊的版本則用VALUES(name),這仍然有效但已被棄用。INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new ON DUPLICATE KEY UPDATE name = new.name; -
若要刻意略過重複資料,請使用
INSERT IGNORE。它會把這個錯誤連同其他幾種錯誤一併降為警告,所以事後要檢查SHOW WARNINGS之後。INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
如果重複發生在
AUTO_INCREMENT,請對照資料檢查計數器。SELECT MAX(id) FROM users; SHOW CREATE TABLE users; -- shows AUTO_INCREMENT=n
安全地重現問題
CREATE TEMPORARY TABLE t (id INT PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR 1062 (23000): Duplicate entry '1' for key 't.PRIMARY'
問題
如何找出重複資料落在哪個鍵上?
訊息會指出它: for key 'PRIMARY' 是主鍵,其他則是唯一索引的名稱。 SHOW INDEX FROM table_name; 列出索引及其欄位。
相關錯誤
1452外鍵失敗:無法新增子資料列1048欄位不可為 NULL1586索引鍵的重複項目(含鍵名)23505PostgreSQL:重複鍵值違反唯一條件約束2627SQL Server:違反 PRIMARY KEY 或 UNIQUE KEYORA-00001Oracle:違反唯一條件約束SQLITE_CONSTRAINT_UNIQUESQLite:UNIQUE 約束失敗
更多索引鍵與條件約束錯誤
1061重複的鍵名稱1451外鍵失敗:無法刪除父資料列1216無法新增或更新子資料列1217無法刪除或更新父資料列1215無法新增外鍵條件約束3780外鍵欄位不相容1822外部索引鍵條件約束缺少索引1824無法開啟被參照的資料表
程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 MySQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。