Define qué debe significar el mensaje
Antes de cambiar el QoS, anota el tema, el contenido, quién publica y quién lo consume. Una lectura periódica de temperatura, la pulsación de un botón y un aviso de disponibilidad no tienen la misma consecuencia. La siguiente lectura puede reemplazar una anterior; una acción repetida quizá no sea aceptable.
La integración MQTT de Home Assistant recibe los mensajes de los temas a los que está suscrita, pero una publicación no equivale a una comprobación completa del equipo o del servicio. Conviene separar tres hechos: el broker aceptó el mensaje, Home Assistant lo recibió y la automatización acabó su ejecución.
Cómo funcionan los niveles QoS 0, 1 y 2
Con QoS 0, el protocolo no usa confirmación de entrega ni reintento. Puede encajar con datos frecuentes y sustituibles, cuando perder una lectura aislada es asumible. Un hueco en los mensajes, por sí solo, no dice en qué punto de la red o de los clientes ocurrió el problema.
Con QoS 1 hay confirmación y puede haber reintentos; por eso el suscriptor puede recibir un duplicado. QoS 2 usa un intercambio de control más largo para garantizar que el mensaje se entregue exactamente una vez entre el emisor y el receptor de ese intercambio MQTT. Ninguno establece que el hecho físico ocurriera una vez, que un servicio estuviera disponible o que una integración posterior ejecutara solo una acción.
Comprueba también la suscripción
Publicar y suscribirse son decisiones distintas. La suscripción solicita un QoS máximo para el tema. El broker entrega el mensaje con el menor nivel entre el QoS de la publicación y el máximo concedido a la suscripción. Comprueba este último en la respuesta SUBACK. Cambiar un único campo no mejora automáticamente cada mensaje del recorrido ni corrige un tema escrito de otra forma.
Consulta los registros de tu propio broker y la configuración de Home Assistant para ver qué tema y qué QoS están definidos. Una conexión de prueba no permite sacar conclusiones sobre otros equipos.
Haz una prueba pequeña y reversible
Prueba un único broker, una red y un tema que administras. Elige un tema de laboratorio, separado de comandos y de datos de equipos importantes. Los clientes de línea de comandos de Mosquitto permiten publicar y suscribirse con el QoS elegido para aislar el comportamiento del broker.
Si también pruebas una automatización, empieza por una acción sin efecto sobre dispositivos físicos, como una entrada en el registro o una notificación persistente. Revisa por separado el registro del broker y la traza de ejecución de la automatización; una conexión correcta no confirma que la regla se ejecutara.
- Crea un tema exclusivo, por ejemplo lab/qos-check-2026-10-23, sin credenciales ni datos personales.
- Suscríbete al tema y anota el QoS elegido y la hora de conexión.
- Publica un mensaje de prueba reconocible con QoS 0 y repítelo con QoS 1.
- Con la sesión persistente y la suscripción QoS 1 ya establecidas, desconecta el suscriptor, publica con QoS 1 y vuelve a conectarlo con el mismo identificador, sin limpiar la sesión y antes de que caduque.
- En una regla de Home Assistant, compara la traza de ejecución de la automatización con el registro del broker antes de tocar equipos reales.
Evita ejecutar dos veces la misma acción
En una automatización con efecto externo, trata las repeticiones como una posibilidad antes de usar QoS 1. Si el publicador documenta un identificador de evento, un contador creciente o una hora fiable, la regla puede comparar ese dato. No inventes un campo ni des por comparables los relojes de máquinas distintas.
Los mensajes retenidos requieren una comprobación separada. Al suscribirse, un cliente puede recibir un estado retenido que se publicó antes de su conexión. No uses el mismo tema para un evento y para un estado retenido, salvo que el diseño del publicador lo documente.
Registra lo que confirmó la prueba
Si un mensaje falta o llega dos veces, guarda el tema, el contenido, el QoS, la hora y los registros del cliente antes de modificar la configuración. Estos datos pueden ayudarte a investigar la causa. Para distinguirla, quizá necesites correlacionar los registros del publicador y del broker, las suscripciones y las trazas de Home Assistant; el contenido y la hora no bastan por sí solos. Cambia una sola variable cada vez y repite el ensayo de laboratorio.
DeviceShelf Server puede publicar observaciones de red en una instalación de Home Assistant que administras. Úsalas como otro dato para comparar con la hora y los registros del equipo: no prueban por sí solas la entrega MQTT, la identidad, la disponibilidad ni el éxito de una automatización.
Herramientas de red gratuitas
La consulta se realiza en tu navegador. Una asignación IEEE es una pista, no una prueba del modelo o del propietario del dispositivo.
Fuentes y referencias
¿Qué dispositivos hay en tu red?
Leer la transcripción
¿Qué dispositivos hay en tu red? Una breve demo de DeviceShelf.
Escanea tu red local y revisa los dispositivos encontrados.
Compara nombres, fabricantes y direcciones IP en un mismo inventario.
Abre un dispositivo para consultar sus datos y puertos abiertos.
La IA opcional aporta pistas para identificarlo. Revisa los indicios antes de sacar conclusiones.
Consulta la disponibilidad, los tiempos de respuesta y las caídas registradas.
La edición de servidor reúne el inventario de la red en un solo lugar.
Revisa los eventos de conexión, desconexión y nuevos dispositivos.
Prueba DeviceShelf gratis durante 7 días. Licencia Personal: 59 € en un pago · deviceshelf.app
Sigue leyendo
Comprueba qué hay conectado a tu red con DeviceShelf
Prueba el inventario y el monitoreo durante 7 días en Windows, macOS o Linux. Después, la licencia Personal cuesta 59 € en un único pago. El escaneo básico funciona sin cuenta y sin IA.