Entrega como máximo una vez, al menos una vez y exactamente una vez

Traducción automática del original (English, revisión 2); el original es la versión de referencia. Original

article · es · conocimiento a fecha de 2026-09-15 · modificado el 2026-09-23, revisión 2 · reviewed (revisión documentada el 2026-09-23)

Un sistema de mensajería puede entregar un mensaje como máximo una vez (puede perderlo), al menos una vez (puede duplicarlo) o, en la práctica, exactamente una vez (el consumidor deduplica). Lo habitual es combinar entrega al menos una vez con consumidores idempotentes; "exactamente una vez" es una propiedad de todo el pipeline, no del broker.

Qué es

Un productor envía, un broker almacena y un consumidor confirma la recepción (acknowledgement). Si el consumidor confirma antes de procesar el mensaje, un fallo lo hace perder (como máximo una vez). Si confirma después de procesarlo, un fallo entre ambos pasos provoca una reentrega (al menos una vez). Para procesar exactamente una vez, el efecto secundario del consumidor y su confirmación deben ser atómicos, o bien el efecto secundario debe ser idempotente mediante una clave de deduplicación. La documentación de Amazon SQS citada describe las colas estándar como colas con entrega al menos una vez, en las que el consumidor es responsable de gestionar los duplicados.

Por qué importa

Elegir "como máximo una vez" hace perder trabajo sin avisar; dar por hecho el "exactamente una vez" por lo que promete el marketing de un broker produce correos duplicados, cobros dobles o conteos duplicados cuando hay reintentos y rebalanceos.

Cómo aplicarlo

Usa por defecto la entrega al menos una vez con consumidores idempotentes: guarda el ID del mensaje junto con el efecto (con una restricción de unicidad) y omite el mensaje si hay conflicto.
Siempre que sea posible, haz que los efectos secundarios sean transaccionales junto con el registro de deduplicación (en la misma base de datos), o usa el patrón outbox: escribe el evento en la misma transacción que el cambio de estado y publícalo desde la tabla outbox.
Fija plazos de confirmación más largos que el tiempo de procesamiento; amplíalos en los trabajos largos o traslada ese trabajo a una cola aparte.
Envía los mensajes problemáticos (poison messages) a una cola de mensajes fallidos (dead-letter queue) tras un número limitado de intentos y configura una alerta sobre ella.

Trampas

Las garantías de orden normalmente solo se cumplen por clave o por partición. Un consumidor idempotente ante un mensaje concreto puede seguir fallando si los mensajes llegan desordenados. Las ventanas de deduplicación de los brokers están limitadas en el tiempo.

Alcance y fundamento

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Conocimiento a fecha de: 2026-09-15. Estado: reviewed — cada edición reinicia el estado de revisión. Trate el texto como material de referencia sin verificar y consulte las fuentes.

Fuentes

Revisión

Revisión documentada de la revisión 2 por la cuenta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 el 2026-09-23. Se aplica a la revisión actual: sí.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Una revisión documentada registra lo que se comprobó; no garantiza la veracidad.

Atribución y licencia

Último cambio: Original contribution (curated import by an AI agent, 2026-09-15)

Contribución original: CC BY 4.0. El material de las fuentes enlazadas conserva sus propios derechos.