Patrón saga y acciones compensatorias
Pago capturado. Inventario reservado. La etiqueta de envío falló — y el pedido queda en un estado que ningún servicio posee. El patrón saga secuencia pasos distribuidos con acciones compensatorias: lógica explícita de deshacer que debe ser idempotente, ordenada y segura para ejecutar más de una vez.
El flujo de checkout tocó tres servicios. Pago autorizado. Inventario decrementado. La API del carrier hizo timeout al crear la etiqueta. El pago aún no estaba capturado — pero el inventario ya mostraba cuarenta unidades menos. Soporte encontró el pedido en PENDING_LABEL en ningún runbook. SQL manual arregló una fila; tres webhooks de reintento duplicados crearon dos pedidos parciales más. El patrón saga con acciones compensatorias existe porque no hay COMMIT distribuido entre microservicios de pago, inventario y envío — solo transacciones locales, mensajes asíncronos y fallo en cualquier paso. Las sagas hacen explícitos los procesos de negocio multi-paso: los pasos forward avanzan estado, los fallos disparan pasos compensatorios que deshacen semánticamente el trabajo previo, y cada handler asume entrega at-least-once.
El two-phase commit entre servicios heterogéneos es operativamente pesado — coordinadores, timeouts de lock, recuperación de fallos frágil. La mayoría de equipos de producto lo rechazan. La coreografía ingenua — "cada servicio escucha y reacciona" — oculta orquestación en cadenas de eventos implícitas que nadie puede trazar cuando el paso cuatro falla. Las sagas ocupan el medio: estado de proceso visible, orden de compensación definido, handlers idempotentes y aceptación de que la consistencia es eventual dentro de un tiempo acotado.
Coreografía vs orquestación: dos formas de saga
Ambas implementan la misma idea — una secuencia de transacciones locales con compensaciones — pero difieren en el flujo de control.
Coreografía. Cada servicio completa su paso y publica un evento. Los servicios downstream se suscriben y actúan. La compensación se propaga como eventos compensatorios en orden inverso de dependencia. Sin coordinador central.
OrderCreated → PaymentReserved → InventoryReserved → LabelFailed
→ InventoryReleased (compensate) → PaymentReleased (compensate) → OrderCancelled
Pros: acoplamiento suelto, sin single point of failure para lógica de orquestación. Contras: grafo implícito difícil de visualizar, orden de compensación codificado en convenciones de topics, debugging requiere alfabetización en distributed trace.
Orquestación. Un coordinador de saga (servicio state machine) emite comandos a participantes, rastrea el paso actual y despacha compensaciones ante fallo. Los participantes reportan éxito o fallo; el coordinador decide el siguiente paso forward o backward.
Coordinator: RESERVE_PAYMENT → ok → RESERVE_INVENTORY → ok → CREATE_LABEL → fail
→ COMPENSATE_INVENTORY → COMPENSATE_PAYMENT → SAGA_FAILED
Pros: estado explícito, política de compensación centralizada, timeouts y escalación humana más fáciles. Contras: la disponibilidad del coordinador importa; puede convertirse en god service si los límites se difuminan.
| Factor | Choreography | Orchestration |
|---|---|---|
| Conteo de pasos | Pocos, estables | Muchos, ramificados |
| Topología de equipo | Equipos autónomos por servicio | Platform posee flujos transversales |
| Necesidades de visibilidad | Herramientas de trace fuertes | Tabla de estado de saga integrada |
| Complejidad de compensación | Eventos reversos simples | Compensación parcial condicional |
| Timeout / enforcement de SLA | Timers por servicio | Deadlines del coordinador |
Ninguna es universalmente correcta. Checkout con cinco pasos e impacto en ingresos suele merecer un orquestador. Pipelines de notificación de dos servicios a menudo sobreviven con coreografía.
Las acciones compensatorias no son rollbacks
El rollback de base de datos deshace una transacción antes del commit. Las acciones compensatorias deshacen efectos de negocio ya confirmados en otros servicios — semánticamente, no mecánicamente.
| Forward step | Naive rollback (wrong) | Compensating action (right) |
|---|---|---|
| Capturar pago | DELETE payment row | Emitir reembolso o liberar hold de autorización |
| Reservar inventario | Revertir transacción si misma DB | Liberar reserva; restaurar conteo disponible |
| Enviar email de confirmación | Imposible de deshacer envío | Enviar email de corrección; marcar saga failed |
| Crear envío | DELETE si mismo servicio | Anular etiqueta; cancelar solicitud de pickup |
| Publicar domain event | Esperar que nadie consumió | Emitir evento compensatorio; consumidores revierten |
Las compensaciones son operaciones de negocio con sus propias reglas. Reembolsar un pago capturado puede tardar tres días. Anular una etiqueta puede fallar si el carrier ya escaneó el paquete. La lógica de compensación debe manejar "deshacer no posible" — escalar a humano, compensación parcial o aceptar estado residual con reconciliación.
Una acción compensatoria que asume que el paso forward nunca tuvo éxito parcial corromperá estado en reintento.
Diseñar compensaciones idempotentes desde el día uno — los mismos patrones que upserts idempotentes en Postgres: dedup key por comando de compensación, unique constraint en (saga_id, step, direction), upsert de estado de compensación para que mensajes duplicados no reembolsen dos veces.
Estado de saga y outbox en cada paso
Cada paso forward y compensatorio debe ser una transacción local: actualizar estado de dominio, registrar progreso de saga, emitir siguiente comando o evento.
BEGIN;
UPDATE inventory
SET reserved = reserved - $qty, available = available + $qty
WHERE sku = $1 AND order_id = $2;
INSERT INTO saga_step_log (saga_id, step, direction, status, idempotency_key)
VALUES ($saga_id, 'release_inventory', 'compensate', 'completed', $key)
ON CONFLICT (idempotency_key) DO NOTHING;
INSERT INTO outbox (aggregate_id, event_type, payload)
VALUES ($saga_id, 'InventoryReleased', $payload);
COMMIT;El patrón transactional outbox asegura que los eventos de compensación sobrevivan crash de proceso — crítico porque el fallo suele disparar compensación durante inestabilidad. Publicar eventos de compensación fuera de la transacción recrea el dual-write gap en el peor momento.
Opciones de almacenamiento de estado de saga:
Tabla de coordinador. saga_instances(id, type, current_step, status, context_json, updated_at) — el orquestador lee y escribe.
Event log. Eventos de saga append-only; un projector construye estado actual — alineado con event sourcing a granularidad de saga.
Log de participación por servicio. Cada servicio registra su paso para un saga_id — modelo de coreografía; la reconciliación une logs.
Los valores de status necesitan precisión: RUNNING, COMPENSATING, COMPLETED, FAILED, COMPENSATION_FAILED (requiere humano). COMPENSATION_FAILED no es opcional en sistemas maduros — algunas rutas de deshacer fallan.
Ordenar compensación: reverso, parcial y pasos pivot
Cuando el paso N falla, compensar N-1, N-2, … hasta los pasos forward completados. El orden importa cuando la compensación downstream depende de liberación upstream — liberar inventario antes de reembolsar pago si el reembolso dispara reorden automático que re-reserva stock.
Regla de orden inverso. Compensar en orden inverso de finalización de pasos forward. Si pago e inventario tuvieron éxito, el inventario suele compensarse primero (restaurar stock) antes del pago (liberar fondos) — dependiente del dominio, documentar por tipo de saga.
Progreso forward parcial. El paso tres falla; los pasos uno y dos confirmados. Compensar dos, luego uno — nunca saltar porque el paso tres nunca empezó.
Pasos no compensables. Email enviado, API externa llamada sin endpoint de void. La saga marca COMPLETED_WITH_IRREVERSIBLE_SIDE_EFFECT, dispara workflow humano, no finge rollback completo. Diseñar pasos forward compensables — retrasar envío hasta commit de saga — es elección arquitectónica.
Pivot / retry vs compensate. Timeout transitorio del carrier podría reintentar creación de etiqueta tres veces antes de compensar inventario. El coordinador distingue fallos reintentables (mismo paso, backoff) de fallos terminales (cadena de compensación). Difuminar los dos causa reembolsos prematuros o bucles infinitos de reintento.
Forward: S1 ──► S2 ──► S3 (fail terminal)
Compensate: ◄── C2 ◄── C1
Timeouts, obsolescencia y garbage collection de saga
Las sagas de larga duración se estancan cuando un participante nunca responde. Sin timeouts, el inventario queda reservado indefinidamente.
Deadline por paso. El coordinador programa evento de timeout; al dispararse, tratar como fallo y compensar pasos completados — o escalar si la compensación es riesgosa.
TTL de saga. Sagas en RUNNING más tiempo que el SLA de negocio (p. ej. 24 horas para checkout) fallan automáticamente y compensan. Alertar antes de auto-acción cuando sea posible.
Compensación obsoleta. Mensaje de compensación llega después de que el reintento forward tuvo éxito — carrera clásica. Contadores de versión en instancia de saga: ignorar compensación para step_version reemplazado por reintento exitoso. saga_epoch monótono por instancia.
Reintento forward idempotente. El paso tres falla transitoriamente; el reintento no debe re-ejecutar efectos secundarios del intento parcial del paso tres. Usar idempotency keys en APIs externas; revisar log de participación antes de llamar carrier create dos veces.
Testing y observabilidad para corrección de saga
Las sagas fallan en producción de formas que los unit tests no capturan: entrega duplicada, carrera compensación-antes-forward, éxito externo parcial.
Matriz de test.
| Scenario | Expected outcome |
|---|---|
| Todos los pasos tienen éxito | COMPLETED, sin compensación |
| Paso k falla terminal | Pasos 1..k-1 compensados, FAILED |
| Comando forward duplicado | Un solo efecto secundario |
| Compensación duplicada | Un solo undo |
| Crash tras commit forward, antes de outbox | Relay entrega; sin doble forward |
| Compensación falla | COMPENSATION_FAILED, alerta |
Tracing. Propagar saga_id y step en cada línea de log, header de mensaje y atributo de span. Dashboards: sagas por status, tiempo medio de completitud, tasa de compensación, sagas atascadas pasado deadline.
Jobs de reconciliación. Nightly comparar capturas de pago con reservas de inventario y etiquetas enviadas — las sagas sanan drift que la automatización pierde.
Límites de saga y cuándo no usar el patrón
No toda interacción multi-servicio es una saga. Read paths que agregan datos de tres APIs — no requiere saga. Escritura forward única con notificación async — outbox más consumidor idempotente basta. Reservar complejidad de saga para workflows donde múltiples pasos confirmados deben deshacerse como unidad cuando pasos posteriores fallan.
Señales de que las sagas valen su costo:
- Impacto en ingresos o inventario si queda en estado parcial toda la noche
- Partners externos (pago, envío, ERP) cada uno con modos de fallo independientes
- Proceso visible para el usuario que abarca minutos a horas (onboarding, provisioning, fulfillment)
- Requisito regulatorio de probar audit trail de pasos forward y compensatorios
Señales para simplificar:
- Dos servicios, un evento, compensación es "borrar la fila que acabamos de insertar"
- Fallo aceptable como cola de limpieza manual revisada semanalmente
- Todos los pasos comparten una base de datos — usar transacción local en su lugar
Sobre-saga-ing crea cuellos de botella de coordinador y cadenas de compensación para flujos que un solo BEGIN…COMMIT resolvería. Sub-saga-ing deja estado parcial como conocimiento tribal en macros de soporte.
¿Cómo deben implementar los equipos sagas con acciones compensatorias?
Elecciones de implementación que previenen incidentes con forma de saga.
¿Cuándo basta coreografía?
Dos a tres servicios, flujo lineal, compensaciones son reversiones simples de eventos, el equipo comparte rotación on-call. Añadir orquestación cuando aparece ramificación, SLAs se endurecen o compensación requiere lógica condicional.
¿Qué tan granular deben ser los pasos de saga?
Un paso con significado de negocio por transacción local — no uno por sentencia SQL, no todo el checkout en un paso. Pasos más finos aumentan precisión de compensación; pasos más gruesos simplifican coordinación pero amplían blast radius de fallo parcial.
¿Deben las compensaciones llamar APIs externas de forma síncrona?
Preferir comandos de compensación async con handlers idempotentes — igual que pasos forward. Compensación síncrona en el hilo de request HTTP acopla latencia de usuario a disponibilidad de API de void del carrier.
¿Cómo se relacionan las sagas con two-phase commit?
Las sagas intercambian atomicidad por disponibilidad y simplicidad. Aceptar inconsistencia temporal (inventario liberado, reembolso pendiente) con status claro y reconciliación. No simular 2PC con locks entre servicios.
Un argumento común va en la otra dirección
La postura opuesta sostiene que las sagas sobre-ingenierían lo que reintentos e handlers idempotentes resuelven — "solo hacer cada handler idempotente y dejar que el message broker redeliver."
La idempotencia previene efectos forward duplicados; no define qué pasa cuando el paso tres falla después de que los pasos uno y dos se confirmaron. Sin acciones compensatorias, las sagas fallidas dejan recursos reservados, pagos retenidos y pedidos huérfanos — el reintento idempotente del paso tres no libera inventario ante fallo terminal. Los reintentos abordan errores transitorios; las compensaciones abordan fallo terminal y undo semántico. Ambos son necesarios.
Key takeaways
- Los procesos de negocio distribuidos necesitan coordinación explícita de saga — las cadenas de eventos implícitas ocultan ownership del fallo.
- Las acciones compensatorias son undos de negocio idempotentes, no rollbacks de base de datos — diseñar para fallo parcial y pasos irreversibles.
- Cada paso confirma localmente con eventos emitidos por outbox — cambio de estado atómico e intención de mensaje.
- Compensar en orden inverso de pasos forward completados; distinguir fallos reintentables de terminales.
- Timeouts, TTL de saga y guards de versión previenen compensación atascada y en carrera.
- Orquestación encaja en ramificación compleja; coreografía en flujos lineales cortos con tracing fuerte.
- Probar entrega duplicada, timing de crash y fallo de compensación — no solo happy path.
Conclusion
El patrón saga hace del fallo distribuido un input de diseño de primera clase. Los pasos forward avanzan el proceso de negocio; las acciones compensatorias restauran invariantes cuando un paso falla terminalmente; el estado de saga hace visible el progreso en lugar de dispersarlo en logs de servicios.
Los equipos que despliegan workflows multi-servicio sin rutas de compensación documentadas deberían mapear un flujo crítico — identificar pasos forward, escribir acción compensatoria por paso, añadir idempotency keys, cablear outbox en cada límite. El primer drill expone cuántas suposiciones de "rollback" son en realidad tickets manuales de soporte.