修正匯入 SQL dump 時出現的「a foreign key constraint fails」

你匯出一個資料庫，試著載入到全新的實例，結果 MySQL 拋出：

或者在 PostgreSQL 上：

為什麼會發生這種情況

外鍵規定「每一個 orders.user_id 都必須指向一筆已存在的 users.id」。當 dump 在 users 之前就先插入 orders 時，被參照的父資料列還不存在，資料庫便會拒絕這一列。

多數 dump 工具會依字母順序或建立順序來寫入資料表——而不是依外鍵相依順序。因此 orders（子表）經常排在 users（父表）之前，匯入就此中斷。

修正方法 1：依相依關係重新排序 INSERT（正確的做法）

乾淨的解法是在每個子表之前先插入其父表。也就是把外鍵解析成相依圖，並依拓撲順序載入資料表：users → orders → order_items。

在動輒數 GB 的檔案裡手動做這件事非常痛苦——你得跨 CREATE TABLE 與 ALTER TABLE 陳述式追蹤每一個 FOREIGN KEY，還得按正確順序剪下貼上龐大的 INSERT 區塊。

修正方法 2：匯入時停用外鍵檢查

對於一份完整且本來就一致的 dump，你可以在載入時安全地略過驗證。在 MySQL 上，把檔案包起來：

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... 你所有的 INSERT 陳述式 ...
SET FOREIGN_KEY_CHECKS = 1;

在 PostgreSQL 上，於交易中延遲約束：

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... 你所有的 INSERT 陳述式 ...
COMMIT;

之後記得重新啟用檢查，讓日後的寫入仍受驗證。這個方法有效，但只是掩蓋了排序問題——如果 dump 是部分的，你仍可能留下孤立的資料列。

修正方法 3：用 DumpCleaner 自動同時處理兩者

DumpCleaner 讀取 dump，從 CREATE TABLE 與 ALTER TABLE 中擷取每一個外鍵，建立相依圖，並匯出一份可直接匯入的乾淨檔案：

1. 把你的 .sql dump 拖進 DumpCleaner（MySQL、MariaDB、PostgreSQL、SQLite 或 MS SQL）。
2. 選擇 INSERT 順序 → 依相依關係（支援外鍵）。系統會透過拓撲排序自動將父表排在子表之前。
3. 視需要勾選 停用外鍵檢查——它會用適合你資料庫的正確陳述式把輸出包起來。
4. 匯出。匯入新檔案——約束錯誤消失了。

它甚至能偵測循環外鍵，並在無法產生有效順序時提醒你，而不是硬做出一個不可能的順序。

常見問題