// справочник ошибок PostgreSQL

PostgreSQL 23P01: нарушение ограничения исключения

Строка конфликтует с существующей строкой по ограничению EXCLUDE, обычно это перекрывающийся диапазон времени для одной и той же комнаты, ресурса или человека.

SQLSTATE
23P01
Имя
exclusion_violation
Категория
Нарушение ограничения целостности
Сообщение об ошибке
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")).

Что это значит

Исключающее ограничение обобщает уникальность: никакие две строки не могут одновременно удовлетворять всем перечисленным сравнениям. Классическое применение — EXCLUDE USING gist (room_id WITH =, during WITH &&), то есть две брони одной и той же комнаты не могут иметь пересекающихся диапазонов.

23P01 означает, что новая или обновленная строка конфликтует с существующей строкой, показанной в DETAIL строку.

Распространённые причины

  • Двойное бронирование: новый диапазон перекрывается с существующим для того же ключа.
  • Диапазоны с включающими верхними границами ([a,b]), которые затрагивают: [10:00,11:00] и [11:00,12:00] перекрываются в 11:00. Используемая по умолчанию полуоткрытая форма [a,b) избегает этого.
  • Две одновременные транзакции вставляют пересекающиеся диапазоны; вторая завершается ошибкой, когда первая фиксирует изменения.

Как исправить

  1. Найдите конфликтующие строки перед записью или покажите пользователю, какая бронь мешает.

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. Используйте полузакрытые диапазоны, чтобы смежные бронирования не перекрывались.

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. Пропускайте конфликтующие строки с ON CONFLICT DO NOTHING, что работает с ограничениями исключения (DO UPDATE не работает).

    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;

Безопасное воспроизведение

Этот btree_gist расширение позволяет GiST-индексу сравнивать обычные целые числа с =.

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

Связанные ошибки

Больше ошибок нарушения ограничений целостности

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.