Cómo solucionar el error ‘sync failed’ de Mastodon después de actualizar la aplicación

Después de actualizar la aplicación Mastodon en tu teléfono o computadora, es posible que veas un banner rojo que dice “Sync Failed” en la parte superior de tu cronología de inicio. Este error significa que la aplicación no puede actualizar tu feed, obtener nuevas notificaciones ni publicar toots. La causa principal suele ser un token de autenticación caducado o una caché local corrupta que la nueva versión de la aplicación no puede leer. Este artículo explica por qué se rompe la sincronización después de una actualización y proporciona tres métodos probados para restaurar el funcionamiento normal.

Por qué falla la sincronización después de actualizar la aplicación Mastodon

Las aplicaciones de Mastodon almacenan un token de acceso OAuth localmente después de iniciar sesión. Este token demuestra a tu servidor de instancia que la aplicación tiene permiso para leer y publicar en tu nombre. Cuando la aplicación se actualiza, la nueva versión puede cambiar la forma en que almacena o lee ese token. Si el formato del token es incompatible o la aplicación no puede descifrarlo, el servidor rechaza la solicitud de sincronización y devuelve un error 401 o 403.

Una segunda causa común es una caché local corrupta. La aplicación Mastodon almacena en caché las cronologías, notificaciones y miniaturas de medios para acelerar la carga. Una actualización puede introducir un nuevo esquema de base de datos que los archivos de caché antiguos no pueden coincidir. La aplicación entonces no puede leer la caché y aborta la operación de sincronización.

Cambios del lado del servidor que rompen la sincronización

Ocasionalmente, el administrador de tu instancia de Mastodon actualiza el software del servidor. Si el servidor ahora requiere una versión más reciente de la API o un encabezado de autenticación más estricto, el token de la aplicación obsoleta puede dejar de funcionar. En ese caso, el fallo de sincronización aparece después de la actualización de la aplicación simplemente porque lo notaste entonces, pero la causa real es el cambio en el servidor.

Pasos para solucionar el error Sync Failed de Mastodon después de actualizar

Prueba estos métodos en el orden indicado. Cada método es más exhaustivo que el anterior. Detente cuando la sincronización vuelva a funcionar.

Método 1: Borrar la caché de la aplicación

1. Abrir la configuración de la aplicación Mastodon
   Toca el icono de tu perfil en la esquina inferior derecha de la pantalla de inicio. Luego toca el icono de engranaje en la esquina superior derecha para abrir Settings.
2. Ir a la configuración de la cuenta
   En el menú Settings, desplázate hacia abajo y toca Account.
3. Tocar Clear Cache
   Busca el botón Clear Cache cerca de la parte inferior de la pantalla Account. Tócalo. Aparece un cuadro de diálogo de confirmación. Toca OK o Clear.
4. Reiniciar la aplicación
   Cierra por completo la aplicación Mastodon. En Android, deslízala fuera de la lista de aplicaciones recientes. En iOS, toca dos veces el botón de inicio y desliza hacia arriba en la aplicación. En el escritorio, haz clic en File > Exit o cierra la ventana. Vuelve a abrir Mastodon y comprueba si el banner rojo de sincronización desaparece.

Método 2: Cerrar sesión y volver a iniciarla

1. Ir a Settings > Account
   Toca el icono de tu perfil, luego el icono de engranaje y después Account.
2. Tocar Log Out
   Desplázate hasta la parte inferior de la pantalla Account y toca Log Out. Confirma la acción cuando se te solicite.
3. Cerrar la aplicación por completo
   Cierra Mastodon por completo usando el conmutador de aplicaciones de tu dispositivo.
4. Volver a abrir Mastodon e iniciar sesión
   Inicia la aplicación de nuevo. En la pantalla de inicio de sesión, introduce el dominio de tu instancia (por ejemplo, mastodon.social) y toca Continue. Inicia sesión con tu correo electrónico y contraseña. Autoriza la aplicación si tu instancia muestra una pantalla de consentimiento OAuth.
5. Esperar la sincronización inicial
   La aplicación descargará tus cronologías y notificaciones desde cero. Esto puede tardar de 10 a 30 segundos. El banner “Sync Failed” debería haber desaparecido.

Método 3: Reinstalar la aplicación Mastodon

1. Desinstalar la aplicación Mastodon
   En Android, mantén pulsado el icono de la aplicación y toca Uninstall. En iOS, mantén pulsado el icono y toca Remove App y luego Delete App. En el escritorio, ve a Settings > Apps > Apps & features, busca Mastodon y haz clic en Uninstall.
2. Reiniciar el dispositivo
   Apaga tu teléfono o computadora por completo, espera 10 segundos y vuelve a encenderlo. Este paso asegura que no queden datos residuales de la aplicación en la memoria.
3. Instalar la última versión de la aplicación Mastodon
   Abre la tienda de aplicaciones de tu dispositivo (Google Play, Apple App Store o Microsoft Store). Busca Mastodon y toca Install o Get.
4. Iniciar sesión en tu cuenta
   Abre la aplicación recién instalada. Introduce el dominio de tu instancia y tus credenciales. Autoriza la aplicación según sea necesario. La sincronización debería funcionar de inmediato.

Si Mastodon sigue mostrando Sync Failed después de la solución principal

Incompatibilidad de la versión de la aplicación con la API del servidor

Algunas instancias de Mastodon más antiguas ejecutan software de servidor que no admite los endpoints más recientes de la API. Si tu instancia es la versión 3.x y la aplicación requiere la versión 4.x de la API, la sincronización fallará independientemente de la limpieza de caché. Comprueba la versión de tu instancia visitando tu página de perfil en la web y mirando el pie de página. Si muestra una versión inferior a 4.0, contacta con el administrador de tu instancia para actualizarla o considera mudarte a una instancia más nueva.

Fallos de sincronización en aplicaciones de terceros

Si usas un cliente de Mastodon de terceros como Tusky, Fedilab o Ivory, el fallo de sincronización puede deberse a que la aplicación no se ha actualizado para los últimos cambios de la API de Mastodon. Visita el sitio web oficial de la aplicación o su canal de soporte para ver si hay una versión más reciente disponible. Si no existe una actualización, vuelve temporalmente a la aplicación oficial de Mastodon.

Proxy de red o VPN que bloquea la sincronización

Una VPN o un proxy corporativo puede interferir con la conexión WebSocket que Mastodon utiliza para las actualizaciones en tiempo real. Desactiva tu VPN temporalmente y prueba la sincronización. Si el error desaparece, añade el dominio de tu instancia de Mastodon a la lista de excepciones de la VPN o cambia a un servidor VPN diferente.

Aplicación oficial de Mastodon vs cliente de terceros: Fiabilidad de la sincronización

Elemento	Aplicación oficial de Mastodon	Cliente de terceros
Sincronización después de actualizar	Normalmente funciona después de borrar la caché o volver a iniciar sesión	Puede requerir esperar a que el cliente se actualice para coincidir con los cambios de la API
Almacenamiento de tokens	Utiliza el llavero del sistema o el almacenamiento cifrado de la aplicación	Varía según la aplicación; algunas almacenan tokens en archivos de texto sin formato
Limpieza de caché	Botón integrado de borrar caché en la configuración	Puede requerir borrar los datos de la aplicación desde la configuración del dispositivo
Reinstalación necesaria	Rara vez es necesaria; normalmente basta con volver a iniciar sesión	Más común debido a esquemas de base de datos incompatibles

Borrar la caché de la aplicación es la solución más rápida y funciona en la mayoría de los casos. Cerrar sesión y volver a iniciarla resuelve los fallos relacionados con tokens. Reinstalar la aplicación es el recurso final para la corrupción persistente. Si el problema continúa, comprueba la versión de tu instancia y el entorno de red antes de contactar con el soporte.