// MySQL 錯誤參考

MySQL 錯誤 1215:無法新增外鍵約束

MySQL 拒絕了 FOREIGN KEY 定義:欄位類型不一致、父資料表沒有索引,或資料表引擎不支援外鍵。

錯誤號碼
1215
名稱
ER_CANNOT_ADD_FOREIGN
SQLSTATE
HY000
類別
鍵與約束
錯誤訊息
Cannot add foreign key constraint

它的意義

1215 表示外鍵無法建立,但沒說明原因。MySQL 8.0 通常會回報更具體的錯誤(3780 為欄位不相容,1822 為缺少父資料表索引,1824 為缺少父資料表)。詳情請執行 SHOW ENGINE INNODB STATUS 並閱讀 LATEST FOREIGN KEY ERROR 區段。

常見原因

  • 子欄位與父欄位的類型、正負號(INT 對上 INT UNSIGNED)、長度,或字元集與定序。
  • 被參照的欄位不是主鍵,也不是任何索引的起始欄位。
  • 其中一個資料表使用 MyISAM 或其他不支援外鍵的引擎。
  • 建立子資料表時,父資料表還不存在。
  • ON DELETE SET NULL 在宣告為 NOT NULL.

如何修正

  1. 閱讀詳細原因。

    SHOW ENGINE INNODB STATUS;  -- LATEST FOREIGN KEY ERROR
  2. 比較兩側的欄位定義,使其相同。

    SHOW CREATE TABLE customers;
    SHOW CREATE TABLE orders;
  3. 讓欄位型別一致,然後再新增鍵。

    ALTER TABLE orders MODIFY customer_id INT UNSIGNED NOT NULL;
    ALTER TABLE orders ADD CONSTRAINT fk_orders_customer
      FOREIGN KEY (customer_id) REFERENCES customers (id);
  4. 將 MyISAM 資料表轉換為 InnoDB。

    ALTER TABLE customers ENGINE = InnoDB;

相關錯誤

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

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

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

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