RabbitMQ 4.4.0 no termina de arrancar si importas las definiciones con management.load_definitions: el registro se para en Importing concurrently 1 users... y el broker nunca llega a Server startup complete. El fallo viene de Erlang 28 y 29, que cambian el orden de los pasos de arranque, y la imagen oficial rabbitmq:4.4.0 ya trae Erlang 29.1.2. La 4.4.1, del 16 de noviembre de 2026, lo corrige; en la 4.4.0, el arreglo es cambiar a las claves definitions.import_backend y definitions.local.path, las dos juntas. Lo probé el 12 de noviembre de 2026 en Linux arm64 con Docker 29.5.2, y el 18 repetí las pruebas con la 4.4.1. Tienes la versión en inglés de esta guía.

Puntos clave

  • Desde el 17 de noviembre, las etiquetas latest, 4, 4.4 y management de la imagen rabbitmq apuntan a la 4.4.1, que ya arranca con management.load_definitions.
  • Con management.load_definitions en la 4.4.0 (Erlang 29.1.2), el nodo responde a ping pero el broker no arranca: lo dejé más de 10 minutos y no avanzó.
  • Solo con definitions.local.path, el contenedor termina con definitions.import_backend is not set, también en la 4.4.1.
  • Con definitions.import_backend = local_filesystem y definitions.local.path, el nodo arrancó en 1,6 segundos.
  • La corrección de RabbitMQ (#17915) salió el 16 de noviembre en la 4.4.1 y la 4.3.8; con la clave antigua, la 4.4.1 arrancó en 1,5 segundos.

¿Por qué se cuelga RabbitMQ 4.4 al importar las definiciones?

Se cuelga porque un paso de arranque del plugin de gestión depende de otro componente sin declararlo, y con Erlang 28 y 29 ese componente arranca después. Lo explicó Michal Kuratczyk, del equipo de RabbitMQ, en la incidencia #17914[1]: "The bug has been there for 6 years".

Hasta Erlang 27 el orden coincidía por casualidad. En Erlang 28 cambió la función de hash interna, y con ella el orden de los pasos. En mi registro, el paso rabbit_management_load_definitions empieza a importar usuarios antes de que exista definition_import_worker_pool, el grupo de procesos que hace la importación, y se queda esperándolo.

Por eso el fallo apareció al actualizar la imagen y no por un cambio en tu configuración. Las notas de la versión 4.4.0[2] dicen que la serie soporta Erlang 28 y 29. Las imágenes 4.3.7 y 4.3.6 de Docker Hub usan Erlang 27.3.4.19, y con la misma configuración arrancaron sin problema.

Cómo reconocer el cuelgue en los registros

El síntoma es un registro que se detiene en la importación de definiciones sin ningún error. Esta es la configuración que lo provoca, en un fichero de /etc/rabbitmq/conf.d/:

management.load_definitions = /etc/rabbitmq/definitions.json

Con ella, rabbitmq:4.4.0-management escribe el banner, Starting broker..., la primera línea de importación y nada más. Si tu fichero de definiciones no tiene usuarios, la última línea será Importing concurrently 1 vhosts.... Lo mismo pasa con la variante -alpine y con la clave pasada por la variable RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS:

[info] Starting RabbitMQ 4.4.0 on Erlang 29.1.2 [jit]
[info] Asked to import definitions. Acting user: rmq-internal
[info] Importing concurrently 1 users...

El proceso de Erlang sigue vivo, así que el contenedor no se reinicia ni sale con error. Desde fuera, los clientes ven conexiones rechazadas en el puerto 5672 y la interfaz web no responde.

Por qué tu healthcheck con ping no lo detecta

El healthcheck más copiado para RabbitMQ en Docker Compose usa rabbitmq-diagnostics ping, y ese comando da por bueno un broker colgado. ping solo comprueba que el nodo de Erlang responde, no que la aplicación rabbit haya arrancado. Estos son los resultados que obtuve contra el nodo colgado:

Comando Código de salida Resultado
rabbitmq-diagnostics -q ping 0 Ping succeeded
rabbitmq-diagnostics -q check_running 69 has not fully booted yet
rabbitmq-diagnostics -q check_port_connectivity 64 requiere la aplicación rabbit
rabbitmqctl list_vhosts 64 requiere la aplicación rabbit

Lancé dos contenedores con la configuración rota y un healthcheck distinto en cada uno. A los 50 segundos, el de ping estaba healthy y el de check_running estaba unhealthy. Con ping, un servicio que espera con depends_on: condition: service_healthy arranca contra un broker que no acepta conexiones. La guía de healthchecks y reinicios en Docker Compose explica cómo encadenar esas dependencias.

Error al aplicar solo el arreglo del mantenedor: import_backend is not set

Si sustituyes la clave antigua solo por definitions.local.path, el nodo ya no se cuelga, pero termina al arrancar. Michael Klishin, del equipo de RabbitMQ, recomendó en la incidencia usar esa clave porque la de management "has been superseded and removed from the docs many years ago". Con ella sola, el contenedor salió con código 1 y este mensaje, el mismo en la 4.4.0 y en la 4.4.1:

Error during startup: {error,"definition import source is
  configured but definitions.import_backend is not set"}
Runtime terminating during boot

La clave definitions.local.path no basta porque RabbitMQ necesita saber de qué tipo es el origen: un fichero local o una URL por HTTPS. Esa información va en definitions.import_backend.

Arreglo: definitions.import_backend y definitions.local.path

La configuración que arranca en 4.4.0 y en 4.4.1 usa las dos claves de la documentación de importación al arrancar[3]. Estas claves forman parte del núcleo, así que funcionan aunque no actives el plugin de gestión. Sustituye la línea antigua por estas tres:

definitions.import_backend = local_filesystem
definitions.local.path = /etc/rabbitmq/definitions.json
definitions.skip_if_unchanged = true

La tercera línea es opcional: hace que el nodo solo importe cuando cambia el contenido del fichero. Al reiniciar el contenedor con el volumen de datos intacto, el registro ya no mostró ninguna línea Importing. Este es el servicio de Compose que probé, ya con la imagen 4.4.1 y con un healthcheck que sí detecta el cuelgue:

services:
  rabbitmq:
    image: rabbitmq:4.4.1-management
    volumes:
      - ./rabbitmq.conf:/etc/rabbitmq/conf.d/20-definitions.conf:ro
      - ./definitions.json:/etc/rabbitmq/definitions.json:ro
      - rabbitmq-data:/var/lib/rabbitmq
    healthcheck:
      test: ["CMD", "rabbitmq-diagnostics", "-q", "check_running"]
      interval: 10s
      timeout: 10s
      retries: 6
      start_period: 20s
volumes:
  rabbitmq-data:

Con este fichero, docker compose up -d --wait devolvió el control con el servicio healthy. El vhost pedidos y la cola de quórum facturas del fichero de definiciones quedaron creados. Si usas colas de quórum, la comparativa de streams y colas de quórum en RabbitMQ explica cuándo conviene cada una.

Cuánto tarda en arrancar cada configuración

Todas las configuraciones que funcionan arrancan en el mismo tiempo, así que cambiar de clave no tiene coste. Medí el valor Time to start RabbitMQ del registro con el mismo fichero de definiciones: 1 usuario, 2 vhosts, 1 permiso y 1 cola. La configuración con management.load_definitions en 4.4.0 no aparece porque nunca terminó:

Tiempo de arranque de RabbitMQ con definiciones importadas ms · menos es mejor
4.4.0, load_definitions del núcleo
1424 ms
4.3.6, management.load_definitions
1561 ms
4.3.7, management.load_definitions
1562 ms
4.4.0, import_backend + local.path
1569 ms
Ver tabla de valores
Imagen y clavems
4.4.0, load_definitions del núcleo1424 ms
4.3.6, management.load_definitions1561 ms
4.3.7, management.load_definitions1562 ms
4.4.0, import_backend + local.path1569 ms

Valor Time to start RabbitMQ del registro, una ejecución por configuración, Docker 29.5.2 en Linux arm64, 12 de noviembre de 2026.

La primera barra corresponde a otra salida válida: la clave load_definitions sin el prefijo management. también arrancó en 4.4.0. Es la que usó un afectado que gestiona RabbitMQ con el Cluster Operator de Kubernetes. Prefiero las dos claves definitions.* porque son las que documenta RabbitMQ hoy y admiten skip_if_unchanged.

Alternativa: actualizar a la 4.4.1 sin tocar la configuración

Si no puedes tocar la configuración ahora, actualiza la imagen a rabbitmq:4.4.1-management. Sus notas de la versión 4.4.1[4] incluyen la corrección de la incidencia #17914. El 18 de noviembre arrancó con management.load_definitions en 1,5 segundos e importó el vhost pedidos y la cola facturas. Para seguir en la serie 4.3, la 4.3.8 lleva la misma corrección sobre Erlang 27.3.4.19 y arrancó en 1,6 segundos.

Revisa qué etiqueta fija tu fichero de Compose. latest, 4, 4.4 y management ya descargan la 4.4.1 con docker compose pull, pero 4.4.0-management no cambia y se sigue colgando: lo comprobé de nuevo el día 18.

Si la 4.4.0 ya intentó arrancar sobre tu volumen de datos, sube a la 4.4.1 y no bajes de versión. La 4.4.1 arrancó con la clave antigua sobre un volumen en el que la 4.4.0 se había colgado. La 4.3.7 y la 4.3.8 sobre un volumen así se quedaron paradas en el paso de arranque database y a los 5 minutos terminaron con {application_start_failure,rabbit,{{error,timeout},...}}. Si no puedes cambiar de imagen, la 4.4.0 con las claves definitions.* también arrancó sobre ese volumen.

Aunque la 4.4.1 arranque con la clave antigua, cambia a las claves definitions.*. El equipo de RabbitMQ considera la clave de management retirada, y la corrección solo devuelve un comportamiento que ya no documentan. Antes de elegir RabbitMQ para un proyecto nuevo, el artículo sobre cuándo RabbitMQ sigue siendo la opción para colas de mensajes compara las alternativas.

Preguntas frecuentes

¿Afecta a la imagen rabbitmq:4.4.0 sin el plugin de gestión?

No se cuelga, pero tampoco importa nada. Con management.load_definitions en rabbitmq:4.4.0, el nodo arrancó con 3 plugins y rabbitmqctl list_vhosts devolvió una lista vacía; la 4.4.1 se comportó igual. RabbitMQ no crea el vhost ni el usuario por defecto cuando hay definiciones pendientes, así que el broker queda sin vhosts. Las claves definitions.* funcionan en las dos imágenes.

¿Qué versión de RabbitMQ corrige el cuelgue?

La 4.4.1 y la 4.3.8, publicadas en GitHub el 16 de noviembre de 2026. Sus imágenes llegaron a Docker Hub el 17 de noviembre, y desde entonces latest, 4, 4.4 y management apuntan a la 4.4.1. La etiqueta 4.4.0 no cambia, así que un fichero de Compose que la fije se sigue colgando. En la incidencia aguas abajo de Testcontainers para .NET[5], el fallo se tomó primero por un cambio en el mensaje de arranque, y era este mismo cuelgue.

¿Pasa lo mismo en Kubernetes con el Cluster Operator?

Sí, si la clave llega al nodo por RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS o por additionalConfig. El fallo depende de la clave y de la versión de Erlang, no de cómo despliegas. En el operador, pon las claves definitions.* en spec.rabbitmq.additionalConfig.

Conclusión

El cuelgue de RabbitMQ 4.4.0 al arrancar sale de la clave management.load_definitions combinada con Erlang 28 o 29, y no da ningún error. Actualiza a la 4.4.1 y sustituye la clave por definitions.import_backend = local_filesystem y definitions.local.path, las dos juntas. Cambia también el healthcheck de ping a check_running, porque el primero da por sano un broker colgado. Para comprobar tu instalación ahora, busca load_definitions en tus ficheros de configuración y en las variables de entorno del contenedor.

Fuentes: [1] RabbitMQ, incidencia #17914: management.load_definitions breaks on Erlang 28 and 29[1], [2] RabbitMQ, PR #17915: Fix original, management plugin-provided definition import on boot[6], [3] Notas de la versión RabbitMQ 4.4.0[2], [4] Documentación de RabbitMQ: importación de definiciones al arrancar[3], [5] Etiquetas de la imagen rabbitmq en Docker Hub[7], [6] Testcontainers para .NET, incidencia #1803: Can't start rabbitmq 4.4.0[5], [7] Notas de la versión RabbitMQ 4.4.1[4].

Fuentes

  1. incidencia #17914
  2. notas de la versión 4.4.0
  3. documentación de importación al arrancar
  4. notas de la versión 4.4.1
  5. Testcontainers para .NET
  6. RabbitMQ, PR #17915: Fix original, management plugin-provided definition import on boot
  7. Etiquetas de la imagen rabbitmq en Docker Hub