// Référence des erreurs PostgreSQL

PostgreSQL 23P01 : violation de la contrainte d'exclusion

Une ligne entre en conflit avec une ligne existante sous une contrainte EXCLUDE, généralement une plage horaire qui se chevauche pour la même salle, ressource ou personne.

SQLSTATE
23P01
Nom
exclusion_violation
Catégorie
Violation de contrainte d'intégrité
Message d'erreur
conflicting key value violates exclusion constraint "bookings_room_during_excl"
DETAIL:  Key (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) conflicts with existing key (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).

Ce que cela signifie

Une contrainte d'exclusion généralise l'unicité : deux lignes quelconques ne peuvent pas satisfaire en même temps toutes les comparaisons listées. L'utilisation classique est EXCLUDE USING gist (room_id WITH =, during WITH &&), ce qui signifie qu'aucune réservation pour la même salle ne peut avoir des plages qui se chevauchent.

23P01 signifie que la nouvelle ligne ou la ligne mise à jour est en conflit avec la ligne existante montrée dans le DETAIL ligne.

Causes courantes

  • Double réservation : la nouvelle plage chevauche une plage existante pour la même clé.
  • Plages avec bornes supérieures inclusives ([a,b]) qui se touchent : [10:00,11:00] et [11:00,12:00] chevauchement à 11:00. La forme par défaut semi-ouverte [a,b) évite cela.
  • Deux transactions simultanées insérant des plages qui se chevauchent ; la seconde échoue lorsque la première est validée.

Comment le corriger

  1. Trouvez les lignes en conflit avant d’écrire, ou montrez à l’utilisateur quelle réservation est en conflit.

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. Utilisez des plages semi-ouvertes afin que les réservations consécutives ne se chevauchent pas.

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. Ignorez les lignes en conflit avec ON CONFLICT DO NOTHING, ce qui fonctionne avec les contraintes d’exclusion (DO UPDATE ce n'est pas le cas).

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 10:00', '2026-05-01 11:00'))
    ON CONFLICT ON CONSTRAINT bookings_room_during_excl DO NOTHING;

Reproduisez-le en toute sécurité

Le btree_gist l’extension permet à un index GiST de comparer des entiers simples avec =.

CREATE EXTENSION IF NOT EXISTS btree_gist;
CREATE TEMP TABLE b (room int, during tstzrange,
    EXCLUDE USING gist (room WITH =, during WITH &&));
INSERT INTO b VALUES (1, tstzrange('2026-01-01 10:00', '2026-01-01 11:00'));
INSERT INTO b VALUES (1, tstzrange('2026-01-01 10:30', '2026-01-01 12:00'));  -- ERROR: conflicting key value violates exclusion constraint

Erreurs liées

Plus d'erreurs de violation de contrainte d'intégrité

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.