# Exchanges, colas y bindings de RabbitMQ para microservicios
En microservicios, los exchanges, las colas y los bindings de RabbitMQ funcionan como una única unidad de diseño: el tipo de exchange enruta los mensajes, la cola los retiene para un grupo de consumidores (consumer group) y el binding decide qué mensajes llegan a qué cola. Si se equivoca de tipo de exchange, o bien distribuye mensajes a servicios que nunca deberían verlos, o bien descarta sin avisar los que deberían haber ido a otro sitio. Esta guía le ofrece las reglas de decisión, una convención de routing key y un ejemplo práctico.
Elija el tipo de exchange según la forma del conjunto de consumidores, no por preferencia
La pregunta que decide el tipo de exchange es: ¿cuántos grupos de consumidores distintos necesitan este mensaje y necesitan todos el mismo subconjunto? Los hábitos del equipo y lo que se usó en el último proyecto son secundarios.
Direct exchange: un grupo de consumidores por routing key exacta. Úselo cuando un mensaje tenga exactamente un destino correcto que no vaya a cambiar, como payment.charge.requested enrutado a una única cola payment-processing. Los direct exchanges se vuelven incómodos en cuanto un segundo grupo de consumidores necesita la misma clave.
Fanout exchange: cada cola vinculada recibe todos los mensajes, sin evaluar la routing key. Úselo para señales de difusión reales: invalidación de caché, «configuración recargada», un interruptor de emergencia. No recurra a fanout por defecto solo porque sea fácil de configurar; un quinto grupo de consumidores que necesite un subconjunto filtrado le obligará a filtrar en la aplicación, algo que podría haber evitado.
Topic exchange: routing keys jerárquicas que se comparan con comodines. Es la opción empresarial por defecto para microservicios, porque los nuevos grupos de consumidores pueden vincular su propia parte del flujo de eventos sin que el publicador cambie. Ante la duda, use topic.
Headers exchange: enruta según pares clave/valor de las cabeceras (x-match: all o any) en lugar de una routing key. Es poco habitual y solo es adecuado cuando la decisión de enrutamiento no puede expresarse como una cadena separada por puntos porque depende de combinaciones de atributos independientes, como región Y nivel Y feature flag. Si la lógica cabe en a.b.c, use topic.
Adopte una única convención de routing key en todo el sistema: ... Ejemplos: order.order.created, order.order.cancelled, payment.charge.succeeded, payment.charge.failed, inventory.reservation.failed, notification.email.queued.
Los grupos de consumidores se vinculan con comodines sobre este patrón. * coincide exactamente con una palabra; # coincide con cero o más. Un servicio de facturación que solo necesita los resultados de pago vincula payment.charge.*. Un servicio de auditoría que quiere todo el dominio de pedidos vincula order.#. Mantenga estable el segmento de dominio, ya que el binding de cada consumidor depende de él.
Para ver cómo encaja la elección de exchange en el diseño completo de un clúster de producción, incluidos el clustering y la planificación de capacidad, consulte la guía de arquitectura de RabbitMQ en producción.
Colas por grupo de consumidores, no por servicio
El error de topología más común es una cola por servicio, calcada del organigrama por costumbre. Falla en cuanto dos equipos independientes necesitan el mismo flujo de eventos a ritmos distintos, o un grupo de consumidores necesita escalar sin arrastrar al otro.
La unidad correcta es el grupo de consumidores, no el servicio. Tres instancias de inventory-service leyendo la misma cola son consumidores en competencia: cada mensaje va exactamente a una instancia, y RabbitMQ reparte las entregas en round-robin (sujeto al prefetch), lo que da escalado horizontal sin particionamiento a nivel de aplicación. Si una segunda función, lógicamente separada, necesita los mismos eventos de forma independiente, como un sink de analítica en el mismo repositorio, se trata de un segundo grupo de consumidores con su propia cola y su propio binding, no de una cola compartida.
Dos ajustes determinan cómo se comportan los consumidores en competencia bajo carga:
Prefetch count: cuántos mensajes sin confirmar (unacked) entrega RabbitMQ a un canal de consumidor antes de pausar las entregas a ese canal. Si es demasiado alto, una instancia lenta acapara mensajes que otras más rápidas podrían procesar; si es demasiado bajo, cada mensaje paga la latencia de ida y vuelta. Consulte prefetch count de RabbitMQ para dimensionarlo según el tiempo de procesamiento y el número de consumidores.
Tipo de cola: las colas de quórum (quorum queues) deben ser la opción por defecto para todo lo que importe, no las colas clásicas. Se replican entre nodos con Raft, sobreviven a un fallo de nodo sin perder mensajes confirmados y siguen recibiendo inversión en RabbitMQ 4.x, mientras que el mirroring clásico está obsoleto. Las colas clásicas siguen siendo adecuadas para cargas de alto throughput, no duraderas y de un solo nodo, donde no compensa el coste de la replicación. Consulte colas clásicas frente a colas de quórum para conocer las ventajas e inconvenientes.
Nombre las colas según el grupo de consumidores y el subconjunto de eventos, no según el exchange: inventory-service.order-events se entiende mucho mejor seis meses después que q1.
Bindings: enrutamiento muchos a muchos sin descontrol
Un binding es una relación dirigida entre un exchange (o una cola) y un patrón de enrutamiento, muchos a muchos por diseño: un exchange puede tener muchas colas vinculadas con patrones distintos, y una cola puede vincularse varias veces al mismo exchange o a varios exchanges.
La semántica de los comodines importa cuando hay presión: * coincide exactamente con una palabra entre puntos (order.*.created coincide con order.order.created, no con order.line-item.detail.created); # coincide con cero o más palabras, incluida ninguna (order.# coincide con order.created y con order.order.line-item.updated).
La explosión de bindings se produce cuando las routing keys intentan expresar lógica detallada de autorización o de feature flags en lugar de dejar ese filtrado al consumidor o a las cabeceras. Si un solo grupo de consumidores necesita más de cuatro o cinco bindings en un exchange para expresar su suscripción, revise la jerarquía de routing keys antes de añadir un sexto.
Los bindings de exchange a exchange resuelven el enrutamiento por capas: un único punto de publicación con reglas de fan-out distintas por dominio aguas abajo. Un topic exchange en la entrada (platform.events) se vincula a topic exchanges específicos de cada dominio (orders.events, payments.events, inventory.events), cada uno de los cuales se vincula a sus propias colas de consumidores. Los publicadores solo conocen platform.events; se pueden añadir dominios nuevos vinculando un exchange nuevo sin tocar ningún publicador. Este es el mecanismo detrás de la mayoría de las topologías de colas de integración empresarial: encadenar por capas la misma primitiva de exchange y binding, no inventar una nueva.
Topologías de dead-lettering y reintentos
Toda cola de producción necesita una política de dead-letter antes que cualquier otra cosa. Sin ella, un mensaje que el consumidor no puede procesar o bien bloquea la cola en un bucle infinito, o bien se confirma y se descarta sin avisar.
La estructura estándar:
Un dead-letter exchange (DLX) es un exchange normal configurado en la cola principal mediante x-dead-letter-exchange. Un mensaje rechazado con requeue=false, caducado por TTL o que supera un límite de longitud se vuelve a publicar en el DLX en lugar de desaparecer.
Una cola dead-letter (DLQ) se vincula a ese DLX y retiene los mensajes fallidos para su inspección, alertas o replay.
El reintento basado en TTL con una cola de espera ofrece reintentos diferidos sin plugins: publique el mensaje fallido en una cola de espera con un TTL fijo y sin consumidores, cuyo propio DLX apunte de nuevo al exchange de procesamiento original. Al caducar el TTL, el mensaje pasa por dead-letter de vuelta al procesamiento normal. Encadene varias colas de espera (retry-5s, retry-30s, retry-5m) para aplicar backoff.
Delivery limit por defecto: en RabbitMQ 4.x, las colas de quórum limitan la reentrega con un delivery-limit de 20 por defecto, dentro de su seguimiento integrado de mensajes envenenados. Superado ese número, el mensaje pasa a dead-letter automáticamente. Configúrelo explícitamente si una topología de reintentos con colas de espera ya gestiona el backoff, para que ambos mecanismos no se interfieran.
Gestión de mensajes envenenados: los mensajes que fallan de forma determinista (JSON mal formado, un esquema imposible de analizar) no deberían consumir presupuesto de reintentos. Detéctelos al principio del handler y envíelos a dead-letter de inmediato con requeue=false, sin pasar por las colas de reintento.
Cómo documentar el flujo de mensajes en un flujo de pedidos distribuido
Este es el patrón aplicado a una aplicación real: un pedido realizado en una tienda online que pasa por los servicios de pedidos, pagos, inventario y notificaciones.
El servicio de pedidos es propietario de order y publica en un topic exchange, order.events. Al realizar un pedido se publica la routing key order.order.created con el ID del pedido, el ID del cliente y las líneas del pedido. Dos grupos de consumidores se vinculan a este exchange: pagos vincula order.order.created a payment-service.order-created, e inventario vincula la misma clave a inventory-service.order-created. Ambos actúan de forma independiente; ninguno sabe que el otro existe.
Pagos procesa el cobro y publica en su propio exchange, payment.events, con payment.charge.succeeded o payment.charge.failed. Pedidos vincula payment.charge.* a order-service.payment-outcomes para actualizar el estado del pedido en ambos casos. Notificaciones vincula el mismo patrón a notification-service.payment-outcomes para enviar un correo al cliente si el pago falla.
Inventario, tras reservar el stock, publica en inventory.events con inventory.reservation.succeeded o inventory.reservation.failed. Pedidos vincula solo inventory.reservation.failed, ya que un éxito no requiere cambiar el estado del pedido. Notificaciones vincula la misma clave como disparador de un correo de falta de stock.
Documéntelo como lo explicaría en voz alta, no como una tabla: por exchange, su tipo y su dominio; por routing key, quién publica y quién consume; por cola, su propietario, su patrón de binding y su política de dead-letter. Redactado en prosa, sigue siendo revisable en una pull request de una forma que un diagrama por sí solo no permite.
Para descubrir este flujo en un clúster cuya documentación ya no refleja la realidad, hay tres herramientas útiles: rabbitmqctl list_bindings en cada vhost devuelve los bindings en bruto de exchange a cola y de exchange a exchange directamente desde el broker; la API HTTP de gestión (GET /api/exchanges/{vhost}/{name}/bindings/source) ofrece los mismos datos en JSON para auditorías mediante scripts; y el plugin de trazado de mensajes (rabbitmq_tracing, o el exchange firehose) muestra el tráfico real, y detecta bindings que existen pero no reciben nada o tráfico que no llega a ninguna parte. Tiene un coste real, ya que el trazado publica internamente una copia de cada mensaje trazado, así que actívelo durante una ventana de diagnóstico acotada, no de forma permanente.
Patrones orientados a eventos que de verdad aguantan en producción
Distinga pronto entre eventos y comandos. Un evento («pedido creado») es un hecho que ya ha ocurrido; al publicador no le importa quién reaccione, así que lo difunde a través de un topic exchange a todos los grupos que se hayan vinculado. Un comando («cobrar a este cliente») tiene exactamente un destinatario previsto; enrutarlo por una topología de difusión invita a que un segundo servicio lo procese por accidente. Los comandos encajan en un direct exchange o en una cola con un único grupo de consumidores; los eventos, en topic.
Los consumidores idempotentes no son opcionales. La entrega at-least-once, la opción por defecto de RabbitMQ con confirmaciones (ack) manuales, implica que todo consumidor acabará viendo un duplicado, ya sea por una reentrega tras una caída entre el procesamiento y el ack, o por una topología de reintentos que se dispara tras un intento lento pero satisfactorio. Base el procesamiento en el ID del mensaje o en una clave de negocio estable (ID del pedido más tipo de evento) y haga que el handler no haga nada ante una repetición. Es más barato construirlo desde el principio que añadirlo después de que se produzca un cobro duplicado.
Las garantías de orden solo existen dentro de una única cola, y solo con un único consumidor activo leyéndola. En cuanto una cola tiene consumidores en competencia, el orden en toda la cola deja de estar garantizado, porque el procesamiento en paralelo puede terminar fuera de secuencia. Si hay que preservar una secuencia concreta (por ejemplo, todos los eventos de un mismo ID de pedido), use x-single-active-consumer para que un consumidor procese mientras los demás esperan como respaldo en caliente, o particione por una clave estable para que los eventos de una entidad lleguen siempre a la misma cola.
Para cambios de estado que deben ser atómicos con una publicación, no publique desde dentro de la transacción de base de datos. Use el patrón outbox: escriba el evento en una tabla outbox en la misma transacción que el cambio de estado y, después, retransmítalo desde la outbox a RabbitMQ mediante un proceso independiente o un conector de CDC (captura de datos de cambios). Así se elimina el problema de la doble escritura que las topologías de fanout y buena suerte aceptan sin decirlo.
Recurra a RabbitMQ Streams en lugar de una topología fanout cuando los consumidores necesiten hacer replay del histórico, el volumen sea lo bastante alto como para que importe el coste de enrutar cada mensaje o varios grupos de consumidores independientes necesiten cada uno el log completo a su propio ritmo sin competir por los mensajes. Un fanout exchange con una cola por grupo se aproxima a esto con volúmenes bajos, pero no ofrece replay. Para elegir entre streams y Kafka en esta carga de trabajo, consulte RabbitMQ Streams frente a Kafka.
Patrones de integración empresarial que de verdad necesitará
Alternate exchange para mensajes no enrutables: configure x-alternate-exchange en cualquier exchange en el que una publicación pueda no coincidir con ningún binding, ya sea por una routing key con una errata o por un grupo de consumidores que se desvinculó sin avisar. Sin él, un mensaje no enrutable simplemente se descarta, salvo que el publicador haya activado el flag mandatory y vigile la devolución: un modo de fallo silencioso que es mejor no descubrir en mitad de un incidente.
Enrutamiento por tenant: en sistemas multi-tenant, un vhost por tenant (o por nivel) es un límite de aislamiento más sólido que codificar el ID del tenant solo en la routing key. Es un tema lo bastante amplio como para merecer su propio artículo sobre multi-tenancy basada en vhosts; diseñe la nomenclatura de colas y exchanges de modo que separar en vhosts siga siendo un cambio de configuración, no una reescritura.
Petición/respuesta con reply_to: para la rara llamada de apariencia síncrona sobre un transporte asíncrono, configure reply_to en la petición con una cola que escuche el solicitante y correlacione las respuestas con correlation_id. Es preferible la pseudocola direct reply-to de RabbitMQ (amq.rabbitmq.reply-to) a aprovisionar una cola de respuesta nueva por petición, a cambio de que el solicitante permanezca conectado mientras dure la llamada.
Antipatrones que debe evitar
Una cola por microservicio en lugar de por grupo de consumidores, lo que acopla sin que se note funciones no relacionadas al mismo flujo.
Fanout usado por defecto porque no se tomó ninguna decisión sobre la routing key, en lugar de por una semántica de difusión deliberada.
Ningún dead-letter exchange configurado, de modo que un mensaje defectuoso bloquea la cola o desaparece sin dejar rastro.
Reintentos implementados como un bucle de espera y reencolado en la aplicación en lugar de colas de espera basadas en TTL, lo que desperdicia capacidad de los consumidores y oculta el estado de los reintentos a los operadores.
Routing keys que codifican detalles de implementación («service-b-only») en lugar de hechos del dominio, y que dejan de funcionar en cuanto un nuevo grupo de consumidores necesita el mismo evento.
Explosión de bindings: una docena de bindings casi duplicados por cola en lugar de una jerarquía de routing keys expresada en uno o dos patrones.
Colas clásicas elegidas por defecto para datos importantes, cuando las colas de quórum son la opción por defecto más segura y las clásicas requieren una justificación concreta de throughput.
Ningún alternate exchange, de modo que los mensajes no enrutables desaparecen en lugar de aflorar como una condición que genere alertas.
Publicar dentro de una transacción de base de datos en lugar de usar el patrón outbox, lo que crea un riesgo de doble escritura entre el estado y los eventos.
Dar por garantizado el orden de los mensajes en una cola con consumidores en competencia y acabar depurando semanas después un estado desordenado «imposible».
Si está validando un diseño de topología antes de ponerlo en producción, o depurando uno que ya no coincide con su documentación, AceMQ respalda a más de 160 clientes empresariales en más de 26 países con objetivos de respuesta desde 15 minutos, según el plan, soporte para RabbitMQ desde 3.8.x hasta 4.x y línea directa con el equipo principal (Core Team) de RabbitMQ como el único partner MSP de RabbitMQ designado por Broadcom. Obtenga más información sobre el soporte de RabbitMQ o póngase en contacto para que revisemos su topología.
El dead-lettering merece más de un párrafo cuando una cola transporta ingresos. El tratamiento completo, incluidos los delivery limits de las colas de quórum, los bucles de reintento seguros y el reprocesamiento desde una cola de aparcamiento (parking-lot), está en la guía empresarial de dead letter queues en RabbitMQ.
Preguntas frecuentes
¿Qué tipo de exchange de RabbitMQ debo usar en microservicios?
Por defecto, un topic exchange con la convención de routing key <domain>.<entity>.<event>. Le permite añadir nuevos grupos de consumidores sin modificar el publicador, ya que cada uno vincula su propio patrón. Use direct exchanges solo cuando un mensaje tenga exactamente un destino correcto que no vaya a cambiar. Use fanout solo para señales que de verdad deban llegar a todos, como la invalidación de caché. Recurra a los headers exchanges únicamente cuando la decisión de enrutamiento dependa de combinaciones de atributos independientes que no puedan expresarse como una routing key separada por puntos.
¿Cómo se documenta el flujo de mensajes de RabbitMQ entre servicios?
Documente, para cada exchange, su tipo y el dominio al que pertenece; para cada routing key, quién publica y quién consume; para cada cola, el servicio propietario, su patrón de binding y su política de dead-letter, todo redactado en prosa para que pueda revisarse en un pull request. Para contrastarlo con la realidad, ejecute rabbitmqctl list_bindings o consulte el endpoint de bindings de la API de gestión para ver el estado actual, y active el plugin de trazas de mensajes durante una ventana acotada para confirmar que el tráfico circula realmente por donde dicen los bindings.
¿Cada microservicio debe tener su propia cola?
No. La cola debe corresponder a un grupo de consumidores, no a un servicio. Si varias instancias de un mismo servicio se reparten el trabajo, se trata de una sola cola con consumidores en competencia, lo que le da escalado horizontal sin coste adicional. Si una función realmente distinta necesita los mismos eventos de forma independiente, se trata de un segundo grupo de consumidores con su propia cola y su propio binding, aunque esté en el mismo código o en el mismo equipo.
¿Qué diferencia hay entre un dead-letter exchange y una cola de reintentos?
Un dead-letter exchange (DLX) es el exchange al que RabbitMQ vuelve a publicar automáticamente un mensaje rechazado, caducado o que ha superado un límite; una dead-letter queue vinculada a él es donde esos mensajes quedan para su inspección. Una cola de reintentos es una cola de espera independiente con un TTL cuyo propio DLX apunta de nuevo al flujo de procesamiento original, de modo que el mensaje regresa al procesamiento normal tras un retardo. Ambos funcionan juntos: el DLX es el mecanismo, y el reintento mediante una cola de espera es un patrón construido sobre él.
¿Cómo evito procesar mensajes duplicados en RabbitMQ?
Con acknowledgements manuales, RabbitMQ ofrece por defecto entrega at-least-once, así que los duplicados van a producirse, ya sea por una reentrega tras una caída o por una topología de reintentos que se dispara tarde. Diseñe consumidores idempotentes: base el procesamiento en el ID del mensaje o en una clave de negocio estable, como el ID del pedido más el tipo de evento, y trate una repetición como una operación sin efecto. Es mucho más barato incorporarlo desde el principio que añadirlo después de que un efecto secundario duplicado haya llegado ya a un cliente.
¿Cuándo conviene usar RabbitMQ Streams en lugar de un fanout exchange?
Recurra a Streams cuando los consumidores necesiten volver a leer el historial, cuando el volumen sea lo bastante alto como para que importe el coste de enrutar cada mensaje en un exchange clásico, o cuando varios grupos de consumidores independientes necesiten leer el log completo de eventos, cada uno a su ritmo. Un fanout exchange con una cola por grupo de consumidores puede aproximarse a esto con volúmenes menores, pero no permite releer el historial y multiplica el coste de almacenamiento y enrutamiento por cada grupo, algo que no ocurre con un log compartido.
Tanto si está resolviendo un incidente en producción como si planifica una migración o quiere una segunda opinión sobre su arquitectura, nuestro equipo está preparado. Sin discursos comerciales, solo respuestas.