Cómo saber si un error de Home Assistant proviene del cliente o del servidor

Consider que se trata de un error del cliente de Home Assistant cuando un cliente falla pero otro funciona en la misma ruta del servidor; considera que el problema está en el servidor cuando la misma operación falla en todas partes.

Esta primera distinción es más útil que borrar la caché o reiniciar Core por costumbre. Una pantalla de Home Assistant depende del estado del navegador o la aplicación, la ruta de red, el proxy y el comportamiento de WebSocket, las API de Core, las integraciones y, a veces, el almacenamiento. Crea una pequeña matriz que mantenga constantes el servidor y la URL mientras cambias el cliente, y después mantenga constante el cliente mientras cambias la ruta. La primera dimensión que cambie el error identifica la siguiente capa que debes inspeccionar.

Primero, realiza una prueba con la misma ruta y distintos clientes

Abre la misma URL de Home Assistant y la misma página desde un segundo navegador, un perfil privado, la aplicación complementaria u otro dispositivo de la misma red. Si un cliente falla mientras el segundo funciona de inmediato, el servidor ya ha demostrado que puede atender la operación mediante esa ruta, lo que convierte la caché, el almacenamiento local, las extensiones del navegador, los recursos frontend personalizados o la representación del cliente en las hipótesis principales.

Un informe del frontend de 2026 mostró que la configuración fallaba en una ruta de navegador mientras otros modos de acceso se comportaban de forma diferente, y las pruebas posteriores incluyeron controles de caché y del navegador. Ese tipo de comparación entre clientes es útil porque acota el fallo antes de cambiar la configuración del servidor.

No declares culpable al cliente por una sola actualización correcta. Repite la misma acción varias veces y conserva los errores de la consola del navegador. Si todos los clientes fallan cuando se carga la misma tarjeta del panel o los datos de la integración, el recurso común del servidor puede ser el verdadero desencadenante.

Los errores del cliente suelen cambiar con la caché, el navegador o un estado frontend seguro

Los fallos del cliente suelen dejar una señal reconocible: un navegador se queda bloqueado con recursos antiguos, una tarjeta personalizada genera un error de JavaScript o la aplicación complementaria se comporta de forma diferente a un navegador limpio. Una actualización forzada, un perfil privado o las herramientas de desarrollo del navegador pueden cambiar el resultado sin reiniciar Home Assistant.

La guía de resolución de problemas del frontend de Home Assistant considera la caché del frontend como un estado del navegador del cliente. Úsala como comprobación reversible, no como solución universal. Si borrar la caché no cambia nada en varios clientes, deja de repetirlo.

Cuando el modo seguro o la eliminación de un recurso frontend de terceros cambia la página, continúa la investigación en las tarjetas personalizadas, los temas o los recursos del navegador. No reconstruyas Recorder ni reemplaces el SSD por un fallo exclusivo de JavaScript. Por el contrario, si el cliente informa de una respuesta 500 del servidor o todos los dispositivos pierden la misma acción de entidad, avanza hacia las capas posteriores.

Los errores del servidor se repiten en distintos clientes y aparecen en los registros de Core o de las integraciones

Un fallo del servidor normalmente persiste al cambiar de cliente porque la solicitud llega a la misma operación backend defectuosa. Algunos ejemplos son una integración que genera una excepción, un fallo de acceso a la base de datos, una acción de automatización que devuelve un error o la indisponibilidad de Core. El navegador puede mostrar un mensaje genérico, pero la línea correspondiente del registro de Home Assistant identifica al responsable en el servidor.

Un caso de la comunidad en el que varios clientes de navegador y móviles acabaron mostrando el mismo fallo de configuración terminó con la eliminación de una integración de terceros dañada. La lección útil de el mismo error en distintos clientes es que reproducirlo en varios clientes desplaza el límite de nuevo hacia el estado compartido de la aplicación.

Compara las marcas de tiempo entre la acción del usuario y los registros de Home Assistant. Si el cliente falla pero Core no registra nada, es posible que la solicitud no haya llegado a Home Assistant. Si el mismo error de API o de integración aparece en todos los clientes, conserva la configuración del cliente y diagnostica el componente backend.

Featured

ZimaCube 2 NAS personal en la nube para el hogar

ZimaCube2

$799.00 - $2,499.00

Buy Now

Los errores del proxy, DNS y WebSocket se sitúan entre el cliente y el servidor

La falsa dicotomía más común consiste en considerar que todo problema que no sea del cliente pertenece al servidor de Home Assistant. Un proxy inverso, un resolvedor DNS, una VPN, un punto de conexión TLS o una actualización de WebSocket pueden fallar después de que el navegador abandone el dispositivo, pero antes de que Core procese la solicitud. Esta ruta intermedia puede hacer que falle una URL mientras la dirección local directa funciona.

Una guía independiente sobre proxies inversos de Home Assistant muestra que la ruta pública añade encabezados de cliente reenviados y una capa de actualización de WebSocket que el acceso directo desde la LAN no utiliza. Esa ruta de entrada adicional puede fallar mientras el mismo servidor de Home Assistant sigue siendo accesible directamente.

Compara la IP o el nombre de host directo de la LAN con la URL habitual del proxy desde el mismo cliente. Si el acceso directo funciona y el proxy falla, conserva Core e investiga el DNS, TLS, la caché del proxy, los encabezados reenviados o WebSockets. Si ambos fallan de forma idéntica y los registros del servidor coinciden, vuelve a investigar dentro de Home Assistant.

Usa una matriz de dos por dos antes de reiniciar el servidor

Prueba el Cliente A y el Cliente B con la Ruta 1, y después el Cliente A y el Cliente B con la Ruta 2. Registra el estado de carga de la página, la respuesta de la API, el estado de WebSocket, el error de la consola del navegador y la entrada correspondiente del registro de Home Assistant. Esta sencilla matriz separa los patrones de fallo exclusivos del cliente, exclusivos de la ruta y generales del servidor con menos cambios destructivos.

El análisis de ZimaSpace sobre el comportamiento de Home Assistant en conexiones LAN y remotas utiliza la misma separación de rutas cuando la capacidad de respuesta percibida cambia entre clientes o rutas de entrada.

Da por válido el diagnóstico cuando una variable modifique el error de forma fiable y la solución propuesta cambie únicamente esa capa. Reinicia Core solo cuando las pruebas del servidor apunten allí o cuando el reinicio forme parte de la validación posterior a la solución. Escala el caso con la matriz y los registros guardados cuando las cuatro combinaciones fallen de forma diferente, porque ese patrón suele indicar que interviene más de una dependencia.