Nota técnica · PostgreSQL / Bases de Datos Transaccionales
Evitar condiciones de carrera en inventario con PL/pgSQL FOR UPDATE
Por qué la lógica de lectura-comprobación-escritura en el backend de aplicación falla bajo concurrencia y cómo resolverlo dentro de PostgreSQL.
1. El fallo clásico: check-then-act en la capa de aplicación
Cuando un e-commerce gestiona la reserva de stock leyendo primero el valor desde Node.js/Next.js y enviando un UPDATE después, dos peticiones simultáneas sobre la última unidad leen stock = 1 al mismo tiempo. Ambas validan la compra y descuentan stock, provocando sobreventa o valores negativos.
Además, en arquitecturas serverless o con múltiples instancias, un mutex en memoria de la aplicación no sirve porque no se comparte entre procesos.
2. Bloqueo pesimista a nivel de fila en PL/pgSQL
La solución aplicada en producción (Plátano Loco, PostgreSQL en Supabase) encapsula la comprobación y el descuento en una función transaccional atómica en PL/pgSQL usando SELECT ... FOR UPDATE.
FOR UPDATE adquiere un bloqueo exclusivo únicamente sobre la fila afectada durante la transacción: la segunda petición concurrente espera a que la primera haga COMMIT y lee ya el stock actualizado, sin bloquear el resto de la tabla.
-- Patrón atómico ilustrativo en PL/pgSQL
CREATE OR REPLACE FUNCTION reservar_stock(p_producto_id uuid, p_cantidad int)
RETURNS boolean
LANGUAGE plpgsql
AS $$
DECLARE
v_stock int;
BEGIN
IF p_cantidad <= 0 THEN
RAISE EXCEPTION 'Cantidad inválida';
END IF;
-- Serializa únicamente las transacciones que compiten por esta fila
SELECT stock INTO v_stock
FROM inventario
WHERE id = p_producto_id
FOR UPDATE;
IF NOT FOUND OR v_stock < p_cantidad THEN
RETURN false;
END IF;
UPDATE inventario
SET stock = stock - p_cantidad
WHERE id = p_producto_id;
RETURN true;
END;
$$;3. Capas adicionales: restricciones CHECK y Row Level Security (RLS)
- Invariante en esquema: añadir
CHECK (stock >= 0)garantiza a nivel de motor que ninguna consulta pueda dejar datos inconsistentes. - Políticas RLS en Supabase: bloquear modificaciones directas de clientes sobre la tabla de inventario y exponer la operación únicamente a través de la función controlada o rol de servidor.
- Orden determinista: cuando una orden reserva varios productos en la misma transacción, ordenar los IDs antes del
FOR UPDATEpreviene deadlocks entre pedidos cruzados.