// Referencia de errores de PostgreSQL

PostgreSQL 40001: no se pudo serializar el acceso

Bajo REPEATABLE READ o SERIALIZABLE, una transacción concurrente cambió datos de los que depende esta. PostgreSQL la revirtió; reintenta toda la transacción.

SQLSTATE
40001
Nombre
serialization_failure
Categoría
Reversión de transacción
Mensaje de error
could not serialize access due to concurrent update

Qué significa

Los niveles de aislamiento más altos de PostgreSQL prometen que una transacción ve una instantánea coherente. Cuando cumplir esa promesa es imposible porque otra transacción confirmó un cambio conflictivo, PostgreSQL aborta una de ellas con 40001 en lugar de devolver un resultado que no podría ocurrir en un orden serial.

Los mensajes varían según la causa: could not serialize access due to concurrent update o concurrent delete (una fila que intentaste cambiar fue modificada por otra persona después de tu instantánea), y could not serialize access due to read/write dependencies among transactions (SERIALIZABLE detectó un patrón peligroso). La solución es la misma: ejecutar la transacción de nuevo desde el principio.

Causas comunes

  • Dos REPEATABLE READ o SERIALIZABLE las transacciones actualizan la misma fila; la segunda que intenta confirmar falla.
  • A SERIALIZABLE la transacción lee filas que otra transacción luego cambió, en un patrón que podría producir una anomalía.
  • Filas calientes, como un contador o un saldo, actualizadas por muchas transacciones serializables concurrentes.

Cómo solucionarlo

  1. Reintentar. El código que utiliza REPEATABLE READ o SERIALIZABLE debe capturar SQLSTATE 40001 y volver a ejecutar toda la transacción, lecturas incluidas, varias veces con una breve pausa entre intentos.

  2. Mantén cortas las transacciones serializables y que afecten al menor número de filas posible.

  3. Si no necesitas serializabilidad para este trabajo, el nivel predeterminado READ COMMITTED vuelve a leer la última versión de la fila al actualizar en lugar de fallar.

    BEGIN ISOLATION LEVEL READ COMMITTED;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. Bajo SERIALIZABLE, declara las transacciones de solo lectura como tales; SERIALIZABLE READ ONLY DEFERRABLE nunca falla con un error de serialización.

    BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;

Reprodúcelo de forma segura

Ejecuta en dos conexiones separadas en una base de datos de prueba.

-- Session 1:
CREATE TABLE acct (id int PRIMARY KEY, bal int);
INSERT INTO acct VALUES (1, 100);
BEGIN ISOLATION LEVEL REPEATABLE READ;
SELECT bal FROM acct WHERE id = 1;
-- Session 2:
UPDATE acct SET bal = 50 WHERE id = 1;
-- Session 1:
UPDATE acct SET bal = bal - 10 WHERE id = 1;  -- ERROR: could not serialize access due to concurrent update
ROLLBACK;

Errores relacionados

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.