// PostgreSQL-Fehlerreferenz

PostgreSQL 23P01: Verletzung der Ausschlusseinschränkung

Eine Zeile steht im Konflikt mit einer vorhandenen Zeile unter einer EXCLUDE-Bedingung, typischerweise ein überlappender Zeitraum für denselben Raum, dieselbe Ressource oder Person.

SQLSTATE
23P01
Name
exclusion_violation
Kategorie
Integritätsbedingungsverletzung
Fehlermeldung
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")).

Was es bedeutet

Eine Ausschlussbedingung verallgemeinert die Eindeutigkeit: Keine zwei Zeilen dürfen gleichzeitig alle aufgelisteten Vergleiche erfüllen. Die klassische Verwendung ist EXCLUDE USING gist (room_id WITH =, during WITH &&), was bedeutet, dass keine zwei Buchungen für denselben Raum überlappende Zeiträume haben dürfen.

23P01 bedeutet, dass die neue oder aktualisierte Zeile mit der vorhandenen Zeile kollidiert, die in der DETAIL Zeile sieht.

Häufige Ursachen

  • Eine Doppelbuchung: der neue Zeitraum überlappt einen bestehenden für denselben Schlüssel.
  • Bereiche mit einschließenden oberen Grenzen ([a,b]) die daran beteiligt sind: [10:00,11:00] und [11:00,12:00] Überlappung um 11:00. Die standardmäßige halb-offene Form [a,b) vermeidet dies.
  • Zwei gleichzeitige Transaktionen fügen sich überlappende Bereiche ein; die zweite schlägt fehl, wenn die erste committet.

Wie du es behebst

  1. Finde die kollidierenden Zeilen, bevor du schreibst, oder zeig dem Nutzer, welche Buchung im Weg ist.

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. Verwende halboffene Bereiche, damit sich aufeinanderfolgende Buchungen nicht überlappen.

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. Zeilen mit Konflikten überspringen mit ON CONFLICT DO NOTHING, das mit Exclusion-Constraints funktioniert (DO UPDATE nicht).

    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;

Sicher reproduzieren

das btree_gist -Erweiterung ermöglicht einem GiST-Index den Vergleich einfacher Ganzzahlen mit =.

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

Zugehörige Fehler

Weitere Fehler bei der Verletzung von Integritätsbedingungen

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.