Idempotencia en automatizaciones: cómo evitar acciones duplicadas
Para evitar acciones duplicadas al reintentar una automatización, necesitas identificar cada operación y reconocer si ya se ha ejecutado. Ese principio se llama idempotencia: repetir una solicitud sin añadir efectos secundarios. La guía técnica de AWS explica cómo aplicarlo cuando una respuesta se pierde y el resultado queda incierto.

- Asigna una clave estable a cada operación, no a cada intento.
- Reserva esa clave antes de ejecutar la acción.
- Comprueba el destino cuando no sepas si la operación terminó.
Qué debes identificar como duplicado
No confundas una operación repetida con dos operaciones legítimas parecidas. Crear dos tareas con el mismo título puede ser intencionado. AWS recomienda expresar esa intención mediante un identificador de solicitud, en lugar de deducirla únicamente de datos idénticos, según su análisis de identificadores y reintentos.
Como propuesta de diseño, combina el sistema de origen, el identificador del evento y la acción: soporte:incidencia-842:crear-tarea. Conserva esa clave durante los reintentos. Si necesitas crear otra tarea deliberadamente, define una operación distinta.
Cómo diseñar el control paso a paso
Propongo este esquema para una automatización que convierte incidencias en tareas internas. Es un diseño orientativo, no una configuración lista para cualquier herramienta.
- Define la identidad. Decide qué evento autoriza una tarea y qué cambios deben generar operaciones nuevas.
- Reserva la clave. Guarda un registro único antes de continuar. En PostgreSQL, una restricción única junto con
INSERT ... ON CONFLICT DO NOTHINGpermite evitar otra inserción con la misma clave. Comprueba si realmente insertaste el registro antes de ejecutar la acción, como permite documentar la cláusula RETURNING. - Distingue estados. Si está completada, recupera el resultado; si sigue en curso, no arranques otra ejecución. AWS Powertools documenta registros persistentes con estado, caducidad y resultado.
- Protege también el destino. Si su API admite idempotencia, utiliza su mecanismo documentado. No presupongas que cualquier campo identificador ofrece esa garantía.
- Guarda la confirmación. Registra el identificador de la tarea creada y marca la operación como completada.
Ejemplo de comprobación
En pruebas, envía dos veces la incidencia ficticia 842 y después lanza dos ejecuciones simultáneas. El resultado esperado es una sola tarea. Simula también una interrupción después de crearla, pero antes de registrar la confirmación: ese caso debe activar una comprobación del destino, no una creación ciega.
Límites: el registro local no lo resuelve todo
Reservar una clave local no hace atómica una llamada a otro sistema. Si este crea la tarea y la respuesta se pierde, queda incertidumbre. La guía de AWS explica este problema y la necesidad de comprobar el resultado. Sin garantías del destino, deriva los casos ambiguos a revisión.
La caducidad también importa: un registro vencido puede permitir otra ejecución, como documenta Powertools. Define la conservación según tus posibilidades de reenvío y recuperación; no copies un valor sin analizar el proceso.
Preguntas frecuentes
¿Debo generar otra clave al reintentar?
No para la misma operación: conserva la original para reconocer la repetición.
¿Basta con buscar antes de insertar?
No como protección frente a ejecuciones simultáneas. Utiliza una restricción única y gestiona el conflicto.
¿Una operación en curso equivale a completada?
No. Debes distinguir ambos estados y prever cómo revisar ejecuciones interrumpidas.
¿Cómo empiezo sin rediseñarlo todo?
Elige una acción concreta y prueba duplicados, concurrencia y pérdida de confirmación antes de ampliar el patrón.