// Referência de erro do PostgreSQL

PostgreSQL 23P01: violação de restrição de exclusão

Uma linha entra em conflito com uma linha existente sob uma restrição EXCLUDE, normalmente um intervalo de tempo que se sobrepõe para a mesma sala, recurso ou pessoa.

SQLSTATE
23P01
Nome
exclusion_violation
Categoria
Violação de restrição de integridade
Mensagem de erro
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")).

O que significa

Uma restrição de exclusão generaliza a unicidade: nenhum par de linhas pode satisfazer todas as comparações listadas ao mesmo tempo. O uso clássico é EXCLUDE USING gist (room_id WITH =, during WITH &&), significando que duas reservas para a mesma sala não podem ter intervalos sobrepostos.

23P01 significa que a nova linha ou a linha atualizada entra em conflito com a linha existente mostrada em DETAIL linha.

Causas comuns

  • Uma reserva dupla: o novo intervalo se sobrepõe a um existente para a mesma chave.
  • Intervalos com limites superiores inclusivos ([a,b]) que se tocam: [10:00,11:00] e [11:00,12:00] sobreposição às 11:00. A forma padrão semiaberta [a,b) evita isso.
  • Duas transações concorrentes inserindo intervalos sobrepostos; a segunda falha quando a primeira é confirmada.

Como corrigir

  1. Encontre as linhas em conflito antes de gravar, ou mostre ao usuário qual reserva está no caminho.

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. Use intervalos semiabertos para que reservas consecutivas não se sobreponham.

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. Ignore linhas em conflito com ON CONFLICT DO NOTHING, que funciona com restrições de exclusão (DO UPDATE não).

    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;

Reproduza com segurança

O btree_gist A extensão permite que um índice GiST compare inteiros simples com =.

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

Erros relacionados

Mais erros de violação de restrição de integridade

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.