// MySQL 錯誤參考

MySQL 錯誤 1062:鍵值重複

INSERT 或 UPDATE 試圖把已存在的值放進 PRIMARY KEY 或 UNIQUE 索引。訊息會指出該值與索引鍵。

錯誤號碼
1062
名稱
ER_DUP_ENTRY
SQLSTATE
23000
類別
鍵與約束
錯誤訊息
Duplicate entry '%s' for key %d

它的意義

當資料列在主鍵或唯一索引上的值與既有資料列相同時,MySQL 會拒絕該資料列。訊息會顯示重複的值與索引,例如 Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 以上版本會在鍵中包含資料表名稱)。

搭配多列 INSERT,重複資料之前的資料列在非交易型資料表(如 MyISAM)上會保留,但用 InnoDB 時整個語句會回滾。

常見原因

  • 重新執行匯入或 seed 腳本,插入已經存在的資料列。
  • 插入已存在的明確 ID,或 AUTO_INCREMENT 計數器原本被設得低於目前最大值。
  • 一個 UPDATE 將唯一欄位更改為另一列已有的值。
  • 在不區分大小寫定序的欄位上建唯一索引: [email protected] 和 [email protected] 算作相同的值。

如何修正

  1. 檢視已經持有該值的資料列。

    SELECT * FROM users WHERE email = '[email protected]';
  2. 若要改為更新現有資料列,請使用 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;
  3. 若要刻意略過重複資料,請使用 INSERT IGNORE。它會把這個錯誤連同其他幾種錯誤一併降為警告,所以事後要檢查 SHOW WARNINGS 之後。

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. 如果重複發生在 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; 列出索引及其欄位。

相關錯誤

更多索引鍵與條件約束錯誤

程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。