Corriger « a foreign key constraint fails » à l'import d'un dump SQL

Vous exportez une base de données, tentez de la charger dans une nouvelle instance, et MySQL renvoie :

Ou, sur PostgreSQL :

Pourquoi cela arrive

Une clé étrangère impose que « chaque orders.user_id pointe vers un users.id existant ». Lorsque le dump insère orders avant users, la ligne parente référencée n'existe pas encore, et la base rejette la ligne.

La plupart des outils de dump écrivent les tables par ordre alphabétique ou par ordre de création — pas selon l'ordre des dépendances de clés étrangères. Ainsi, orders (enfant) se retrouve fréquemment avant users (parent), et l'import échoue.

Solution 1 : réordonner les INSERT par dépendance (la bonne solution)

La solution propre consiste à insérer chaque table parente avant ses enfants. Cela signifie résoudre les clés étrangères en un graphe de dépendances et charger les tables dans l'ordre topologique : users → orders → order_items.

Faire cela à la main dans un fichier de plusieurs gigaoctets est pénible — vous devez retracer chaque FOREIGN KEY à travers les instructions CREATE TABLE et ALTER TABLE et couper/coller d'énormes blocs INSERT dans le bon ordre.

Solution 2 : désactiver les vérifications de clés étrangères pendant l'import

Pour un dump complet et déjà cohérent, vous pouvez sauter la validation pendant le chargement sans risque. Sur MySQL, encadrez le fichier :

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... toutes vos instructions INSERT ...
SET FOREIGN_KEY_CHECKS = 1;

Sur PostgreSQL, différez les contraintes à l'intérieur d'une transaction :

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... toutes vos instructions INSERT ...
COMMIT;

Réactivez les vérifications ensuite pour que les futures écritures restent validées. Cela fonctionne, mais ne fait que masquer le problème d'ordre — si le dump est partiel, vous pouvez toujours vous retrouver avec des lignes orphelines.

Solution 3 : faire les deux automatiquement avec DumpCleaner

DumpCleaner lit le dump, extrait chaque clé étrangère des instructions CREATE TABLE et ALTER TABLE, construit le graphe de dépendances et exporte un fichier propre qui s'importe sans problème :

1. Glissez votre dump .sql dans DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite ou MS SQL).
2. Choisissez Ordre des INSERT → Par dépendances (compatible FK). Les parents sont placés avant les enfants automatiquement par tri topologique.
3. Cochez éventuellement Désactiver les vérifications de clés étrangères — l'instruction adaptée à votre base est ajoutée autour de la sortie.
4. Exportez. Importez le nouveau fichier — l'erreur de contrainte a disparu.

Il détecte même les clés étrangères circulaires et vous avertit au lieu de produire un ordre impossible.

Questions fréquentes