MySQL 建立外鍵失敗？8 大常見原因與排查清單

前言

在 MySQL 中創建外鍵約束時，報錯 ERROR 1215 (HY000): Cannot add foreign key constraint 是家常便飯。本文彙總 8 大高頻成因，附帶檢查指令，助你快速定位解決。

1. 列定義不嚴格匹配（最常見）

• 數據類型、長度、符號位必須完全一致：INT(10) vs INT(11)、INT vs TINYINT、SIGNED vs UNSIGNED 皆不匹配；
• 檢查指令：
  SHOW CREATE TABLE parent_table;
SHOW CREATE TABLE child_table;
  逐字對比 col_name 定義。

2. 參照列缺少索引或非主鍵

• 父表參照列必須是 PRIMARY KEY 或擁有獨立索引；
• 若非主鍵，先執行：ALTER TABLE parent_table ADD INDEX idx_col (col);

3. 存儲引擎不支援外鍵

• 僅 InnoDB 支援外鍵約束；
• 若任一表為 MyISAM：ALTER TABLE t ENGINE=InnoDB;；
• 兩表皆為 MyISAM 時不會報錯，但只會建立索引，不生效約束——極具欺騙性。

4. 外鍵名稱重複

• 同一資料庫內外鍵名必須唯一；
• 檢查：SELECT CONSTRAINT_NAME FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE CONSTRAINT_TYPE='FOREIGN KEY';；
• 解決：顯式指定名稱 CONSTRAINT fk_unique_name FOREIGN KEY ... 或加隨機後綴測試。

5. ON DELETE SET NULL 與 NOT NULL 衝突

• 若定義 ON DELETE SET NULL，子表外鍵列必須允許 NULL；
• 修正：ALTER TABLE child_table MODIFY col_name type NULL; 或改用 ON DELETE CASCADE / RESTRICT。

6. 字符集與校對規則不一致

• 表級、列級 CHARSET 與 COLLATION 必須完全一致；
• 檢查：SHOW TABLE STATUS LIKE 't';、SHOW FULL COLUMNS FROM t;；
• 統一修正：ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

7. 外鍵列設有 DEFAULT 值

• MySQL 禁止外鍵列有預設值（如 DEFAULT 0）；
• 移除：ALTER TABLE child_table ALTER COLUMN col_name DROP DEFAULT;

8. ALTER TABLE 語法錯誤

• 拼寫錯誤、缺少括號、引用不存在的列/表；
• 參考標準語法：
  ALTER TABLE child_table
ADD CONSTRAINT fk_name
FOREIGN KEY (col_name)
REFERENCES parent_table (col_name)
ON DELETE RESTRICT ON UPDATE CASCADE;

排查流程圖（建議收藏）

1. 確認兩表皆為 InnoDB；
2. 對比父/子列定義（類型、長度、符號、字符集、校對）；
3. 確認父列有主鍵或唯一索引；
4. 檢查外鍵名唯一性；
5. 驗證 ON DELETE/UPDATE 與列屬性相容；
6. 移除外鍵列 DEFAULT；
7. 仔細核對 SQL 拼寫。

工具建議：使用 MySQL Workbench、Navicat、DBeaver 等圖形化工具設計表結構，可自動檢測大部分問題，大幅降低人為錯誤率。