Al usar el cliente web de Mastodon, el mensaje de error “Streaming API Disconnected” aparece en la consola del navegador o como una notificación visible. Este error significa que la conexión en tiempo real entre tu navegador y el servidor de Mastodon se ha interrumpido. La API de streaming es responsable de entregar nuevas publicaciones, notificaciones y actualizaciones de la línea temporal sin necesidad de recargar la página. Una desconexión hace que la línea temporal deje de actualizarse en tiempo real hasta que se restablezca la conexión. Este artículo explica la causa raíz de la desconexión y proporciona soluciones paso a paso para restaurar la conexión de la API de streaming.
Conclusiones clave: Restaurar las actualizaciones de la línea temporal en tiempo real
- Consola de desarrollador del navegador (F12) > pestaña Red: Identifica si las conexiones WebSocket están fallando o siendo cerradas por el servidor.
- Página de estado de la instancia de Mastodon: Comprueba si el servidor de streaming está en línea y aceptando conexiones.
- Configuración de extensiones del navegador: Desactiva los bloqueadores de anuncios o extensiones de VPN que puedan bloquear el tráfico WebSocket hacia el dominio de la instancia.
Por qué se desconecta la API de streaming en el cliente web de Mastodon
El cliente web de Mastodon se comunica con el servidor utilizando dos canales principales: solicitudes HTTP para acciones como publicar y cargar páginas, y conexiones WebSocket para la API de streaming. La API de streaming utiliza WebSockets para enviar nuevos datos al navegador en tiempo real. Cuando se interrumpe la conexión WebSocket, el cliente muestra “Streaming API Disconnected”. Esto puede ocurrir por varias razones.
Tiempos de espera y límites de recursos del servidor
La mayoría de las instancias de Mastodon establecen un tiempo de espera en las conexiones WebSocket inactivas. Si no se envían datos durante un período, típicamente de 30 a 60 segundos, el servidor cierra la conexión para liberar recursos. Algunas instancias también limitan el número de conexiones WebSocket simultáneas por usuario. Si tienes varias pestañas abiertas, cada una crea un WebSocket separado, lo que puede exceder el límite.
Interrupciones de red e interferencia de proxy
Las conexiones WebSocket requieren una conexión TCP persistente. Cualquier interrupción de red, como una caída de Wi-Fi, reconexión de VPN o tiempo de espera del servidor proxy, romperá el WebSocket. Las extensiones del navegador que bloquean o modifican el tráfico, particularmente los bloqueadores de anuncios, extensiones de VPN y bloqueadores de scripts, pueden interferir con el handshake de WebSocket o con los paquetes de keep-alive.
Problemas específicos del navegador
Algunos navegadores, especialmente versiones antiguas, tienen errores en su implementación de WebSocket. Los modos agresivos de ahorro de energía en portátiles también pueden suspender la ejecución de JavaScript, lo que provoca que el WebSocket se agote. El cliente web de Mastodon depende de JavaScript para mantener la conexión WebSocket; si el navegador suspende la pestaña, la conexión se cae.
Pasos para solucionar el error de Streaming API Disconnected
Sigue estos pasos en orden. Prueba después de cada paso para ver si el error se resuelve.
- Actualiza la pestaña de Mastodon
Presiona Ctrl+R o F5 en Windows, o Cmd+R en Mac. Esto obliga al navegador a restablecer la conexión WebSocket. Si el error fue temporal, esto puede resolverlo de inmediato. - Cierra otras pestañas de Mastodon
Cada pestaña abierta de Mastodon crea una conexión WebSocket separada. Cierra todas menos una. Espera 10 segundos y comprueba si el error desaparece. - Desactiva temporalmente las extensiones del navegador
Abre el administrador de extensiones del navegador. Desactiva todas las extensiones, especialmente bloqueadores de anuncios, herramientas de privacidad y extensiones de VPN. Reinicia el navegador y abre Mastodon de nuevo. Si el error se detiene, reactiva las extensiones una por una para encontrar la culpable. - Comprueba el estado de la instancia de Mastodon
Visita la página de estado de tu instancia. Muchas instancias tienen un subdominio de estado como status.mastodon.social. Busca el estado del servidor de streaming. Si aparece fuera de línea o degradado, espera hasta que el administrador resuelva el problema. - Limpia la caché y las cookies del navegador para el dominio de la instancia
Ve a la configuración del navegador > Privacidad y seguridad > Borrar datos de navegación. Selecciona “Cookies y otros datos del sitio” e “Imágenes y archivos en caché”. Establece el rango de tiempo en “Últimas 24 horas”. Borra los datos y luego recarga Mastodon. - Usa un navegador diferente
Prueba Mastodon en un navegador que no uses normalmente, como Firefox si usas Chrome, o Edge si usas Firefox. Si el error no aparece, el navegador original puede tener un error de WebSocket o un conflicto de extensiones. - Desactiva temporalmente la VPN o el proxy
Apaga cualquier servicio de VPN o proxy del sistema. Las conexiones WebSocket a menudo fallan a través de VPN debido a restricciones de puertos o modelado de tráfico. Después de desactivarlo, actualiza la pestaña de Mastodon. - Ajusta la configuración de ahorro de energía del navegador
En Windows 11 o Windows 10, ve a Configuración > Sistema > Energía y batería. Establece el modo de energía en “Mejor rendimiento”. En el navegador, desactiva cualquier opción que suspenda las pestañas en segundo plano. Para Chrome, ve a chrome://settings/performance y desactiva “Ahorro de memoria” y “Ahorro de energía”. - Usa la aplicación móvil de Mastodon o un cliente de terceros
Si el cliente web continúa desconectándose, prueba la aplicación móvil oficial de Mastodon o un cliente de escritorio como Tusky o Elk. Estos clientes manejan la reconexión de WebSocket de manera más robusta.
Si la API de streaming aún se desconecta después de la solución principal
El error persiste en múltiples dispositivos en la misma red
Si el error ocurre en diferentes dispositivos conectados al mismo Wi-Fi o LAN, el problema probablemente sea a nivel de red. Comprueba si tu router está bloqueando el tráfico WebSocket. Algunas redes corporativas o escolares bloquean los puertos WebSocket 80 y 443. Contacta a tu administrador de red. Alternativamente, usa un punto de acceso móvil para probar.
El error ocurre solo en una instancia específica
Si puedes conectarte a otras instancias de Mastodon sin problemas, el problema es específico de la instancia que estás utilizando. La instancia puede estar sobrecargada o tener configuraciones incorrectas de WebSocket. Informa el problema al administrador de la instancia. Incluye el mensaje de error exacto y la hora en que ocurrió.
La conexión WebSocket muestra 101 Switching Protocols pero luego se cierra
Abre la consola de desarrollador del navegador con F12. Ve a la pestaña Red y filtra por “WS” o “WebSocket”. Recarga la página. Busca la conexión WebSocket hacia el dominio de tu instancia. Si el estado muestra 101 pero la conexión se cierra después de unos segundos, el servidor está terminando activamente la conexión. Esto podría deberse a límites de velocidad o a la expiración del token de autenticación. Cierra sesión en Mastodon, borra las cookies y vuelve a iniciar sesión.
Reconexión manual de WebSocket vs. Reconexión automática
| Elemento | Reconexión manual | Reconexión automática |
|---|---|---|
| Activador | El usuario actualiza la página o cierra y reabre la pestaña | El navegador o cliente intenta reconectarse después de un retraso |
| Tiempo para restaurar | Inmediato después de actualizar | Generalmente de 5 a 30 segundos dependiendo de la lógica del cliente |
| Fiabilidad | Alta, pero requiere acción del usuario | Varía según la implementación del cliente; puede fallar si el problema subyacente persiste |
| Sobrecarga de red | Recarga completa de la página, mayor uso de datos | Solo handshake de WebSocket, menor uso de datos |
| Mejor para | Desconexiones ocasionales | Desconexiones frecuentes debido a inestabilidad de la red |
El cliente web de Mastodon intenta la reconexión automática después de una desconexión, pero esto puede fallar si no se aborda la causa raíz. Si ves el error repetidamente, no confíes solo en la reconexión automática. Aplica las soluciones anteriores para eliminar la causa.
Después de seguir estos pasos, la conexión de la API de streaming debería permanecer estable. Actualiza la pestaña de Mastodon y verifica que las nuevas publicaciones aparezcan en la línea temporal de inicio sin recarga manual. Si el error continúa en un navegador pero no en otro, considera cambiar al navegador que funcione. Para problemas persistentes en todos los navegadores, consulta la página de estado de la instancia y reporta el problema al administrador.