Sửa lỗi “a foreign key constraint fails” khi import một SQL dump

Bạn export một cơ sở dữ liệu, thử nạp nó vào một instance mới, và MySQL báo lỗi:

Hoặc trên PostgreSQL:

Vì sao lỗi này xảy ra

Một khóa ngoại quy định rằng “mỗi orders.user_id phải trỏ tới một users.id đang tồn tại.” Khi dump chèn orders trước users, dòng cha được tham chiếu chưa tồn tại, và cơ sở dữ liệu từ chối dòng đó.

Hầu hết các công cụ dump ghi bảng theo thứ tự bảng chữ cái hoặc theo thứ tự tạo — chứ không theo thứ tự phụ thuộc khóa ngoại. Vì vậy orders (bảng con) thường được ghi trước users (bảng cha), và quá trình import bị lỗi.

Cách 1: Sắp xếp lại INSERT theo phụ thuộc (cách sửa đúng đắn)

Giải pháp gọn gàng là chèn mọi bảng cha trước các bảng con của nó. Điều đó nghĩa là phân giải các khóa ngoại thành một đồ thị phụ thuộc và nạp các bảng theo thứ tự topo: users → orders → order_items.

Làm điều này bằng tay trong một file nhiều gigabyte thật khổ sở — bạn phải truy vết từng FOREIGN KEY qua các lệnh CREATE TABLE và ALTER TABLE rồi cắt/dán những khối INSERT khổng lồ theo đúng trình tự.

Cách 2: Tắt kiểm tra khóa ngoại trong khi import

Với một dump hoàn chỉnh và đã nhất quán, bạn có thể bỏ qua bước kiểm tra một cách an toàn khi nạp. Trên MySQL, hãy bao file lại:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... tất cả các lệnh INSERT của bạn ...
SET FOREIGN_KEY_CHECKS = 1;

Trên PostgreSQL, hãy hoãn các ràng buộc bên trong một transaction:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... tất cả các lệnh INSERT của bạn ...
COMMIT;

Hãy bật lại kiểm tra sau đó để các lần ghi trong tương lai vẫn được xác thực. Cách này hiệu quả, nhưng nó chỉ che giấu vấn đề thứ tự — nếu dump chưa đầy đủ, bạn vẫn có thể kết thúc với những dòng mồ côi.

Cách 3: Làm cả hai một cách tự động với DumpCleaner

DumpCleaner đọc dump, trích xuất mọi khóa ngoại từ CREATE TABLE và ALTER TABLE, dựng đồ thị phụ thuộc, rồi export ra một file gọn gàng import được ngay:

1. Kéo file .sql của bạn vào DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite hoặc MS SQL).
2. Chọn Thứ tự INSERT → Theo phụ thuộc (nhận biết khóa ngoại). Các bảng cha được tự động đặt trước bảng con nhờ sắp xếp topo.
3. Tùy chọn tích Tắt kiểm tra khóa ngoại — nó bao đầu ra bằng lệnh đúng cho cơ sở dữ liệu của bạn.
4. Export. Import file mới — lỗi ràng buộc đã biến mất.

Nó thậm chí còn phát hiện các khóa ngoại vòng lặp và cảnh báo bạn thay vì tạo ra một thứ tự bất khả thi.

Câu hỏi thường gặp