For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
Solución de problemas de la app móvil
Corrige los fallos habituales de vista previa, configuración y build nativo antes de que lleguen a un tester.
Configuración y ajustes
Si la app no puede alcanzar el backend, recuerda que localhost en un teléfono significa el propio teléfono. Usa la dirección LAN del ordenador, 10.0.2.2 para el emulador de Android o una URL HTTPS de staging. Abre esa dirección primero en el navegador del teléfono; revisa Wi-Fi, firewall y VPN antes de cambiar código. Un túnel de Expo transporta el bundle de la pantalla, no tu API.
Un EXPO_PUBLIC_API_URL ausente o incorrecto aparece como error de configuración antes del inicio de sesión. Un callback rechazado suele significar que el esquema del build y MOBILE_ALLOWED_ORIGINS del servidor no coinciden, o que el callback se ejecutó en Expo Go en lugar del build nativo.
Flujo de implementación
Tras cambiar una dependencia nativa o el esquema, detén Metro, limpia su caché, reconstruye el cliente de desarrollo y reinstala la app. Si solo cambió JavaScript, basta con recargar la vista previa. Mantén la versión del SDK de Expo de la app alineada con Expo Go o el build de desarrollo instalado en el dispositivo.
Verificación y solución de problemas
La vista previa, el inicio de sesión y el enlace profundo funcionan en el dispositivo de destino.