← volver a yonesuarez.es

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 UPDATE previene deadlocks entre pedidos cruzados.