Исправляем «a foreign key constraint fails» при импорте SQL-дампа

Вы экспортируете базу данных, пытаетесь загрузить её в новый экземпляр, и MySQL выдаёт:

Или, в PostgreSQL:

Почему это происходит

Внешний ключ говорит: «каждое значение orders.user_id должно указывать на существующее users.id». Когда дамп вставляет orders раньше users, нужной родительской строки ещё нет, и база данных отклоняет строку.

Большинство инструментов дампа записывают таблицы по алфавиту или в порядке создания — а не в порядке зависимостей внешних ключей. Поэтому orders (дочерняя) часто оказывается перед users (родительской), и импорт ломается.

Способ 1: Переупорядочить INSERT-ы по зависимостям (правильное решение)

Чистое решение — вставлять каждую родительскую таблицу перед её дочерними. Это значит разрешить внешние ключи в граф зависимостей и загружать таблицы в топологическом порядке: users → orders → order_items.

Делать это вручную в многогигабайтном файле мучительно — приходится отслеживать каждый FOREIGN KEY по инструкциям CREATE TABLE и ALTER TABLE и вырезать/вставлять огромные блоки INSERT в нужной последовательности.

Способ 2: Отключить проверку внешних ключей во время импорта

Для полного и уже согласованного дампа можно безопасно пропустить валидацию при загрузке. В MySQL оберните файл так:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... все ваши INSERT-инструкции ...
SET FOREIGN_KEY_CHECKS = 1;

В PostgreSQL отложите проверку ограничений внутри транзакции:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... все ваши INSERT-инструкции ...
COMMIT;

После этого снова включите проверки, чтобы будущие записи оставались валидируемыми. Это работает, но лишь маскирует проблему порядка — если дамп частичный, вы всё равно можете получить осиротевшие строки.

Способ 3: Сделать и то, и другое автоматически с DumpCleaner

DumpCleaner читает дамп, извлекает каждый внешний ключ из CREATE TABLE и ALTER TABLE, строит граф зависимостей и экспортирует чистый файл, который просто импортируется:

1. Перетащите ваш дамп .sql в DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite или MS SQL).
2. Выберите Порядок INSERT → По зависимостям (с учётом FK). Родительские таблицы автоматически размещаются перед дочерними через топологическую сортировку.
3. При желании отметьте Отключить проверку внешних ключей — программа обернёт вывод корректной инструкцией для вашей базы данных.
4. Экспортируйте. Импортируйте новый файл — ошибки ограничения больше нет.

Программа даже обнаруживает циклические внешние ключи и предупреждает вас, вместо того чтобы формировать невозможный порядок.

Часто задаваемые вопросы