// Referencia de errores de PostgreSQL

PostgreSQL 23P01: violación de la restricción de exclusión

Una fila entra en conflicto con una fila existente bajo una restricción EXCLUDE, típicamente un rango de tiempo que se solapa para la misma sala, recurso o persona.

SQLSTATE
23P01
Nombre
exclusion_violation
Categoría
Violación de restricción de integridad
Mensaje de error
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")).

Qué significa

Una restricción de exclusión generaliza la unicidad: no dos filas pueden cumplir todas las comparaciones listadas al mismo tiempo. El uso clásico es EXCLUDE USING gist (room_id WITH =, during WITH &&), es decir, no puede haber dos reservas de la misma sala con rangos que se solapen.

23P01 significa que la fila nueva o actualizada entra en conflicto con la fila existente que se muestra en el DETAIL línea.

Causas comunes

  • Una doble reserva: el rango nuevo se solapa con uno existente para la misma clave.
  • Rangos con límites superiores inclusivos ([a,b]) que tocan: [10:00,11:00] y [11:00,12:00] se solapan a las 11:00. La forma semiespuesta por defecto [a,b) lo evita.
  • Dos transacciones concurrentes que insertan rangos superpuestos; la segunda falla cuando la primera se confirma.

Cómo solucionarlo

  1. Encuentra las filas en conflicto antes de escribir, o muestra al usuario qué reserva está en el camino.

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. Usa rangos semiabiertos para que las reservas consecutivas no se superpongan.

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. Omite las filas en conflicto con ON CONFLICT DO NOTHING, que funciona con restricciones de exclusión (DO UPDATE no lo hace).

    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;

Reprodúcelo de forma segura

La btree_gist la extensión permite que un índice GiST compare enteros simples con =.

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

Errores relacionados

Más errores de violación de restricciones de integridad

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.