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
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
-
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'); -
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', '[)')); -
Omite las filas en conflicto con
ON CONFLICT DO NOTHING, que funciona con restricciones de exclusión (DO UPDATEno 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
23505clave duplicada viola la restricción única23514violación de la restricción CHECK42P10referencia de columna no válida
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.
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.