Página en blanco en tu sitio: árbol de decisión para fundadores

Qué suele significar una “página en blanco"

Una “página en blanco” no siempre es una pantalla blanca literal. A veces ves un encabezado sin contenido, un spinner que nunca termina, o un panel donde la maqueta carga pero las tarjetas quedan vacías.

El error que cometen la mayoría de los fundadores es intentar soluciones al azar (refrescar repetidamente, borrar todo, tocar el código) antes de saber qué tipo de problema es. Un triage rápido convierte un síntoma alarmante en una etiqueta clara: navegador, cuenta o servidor/build.

Antes de tocar nada, pasa dos minutos recopilando señales.

Ten esto listo:

• La URL exacta de la página donde ocurre
• Una ventana de incógnito/privada
• Un segundo navegador (o el mismo navegador en otro dispositivo)
• Un inicio de sesión afectado (y, idealmente, una segunda cuenta)
• Una nota corta sobre lo que ves (pantalla blanca, spinner, maqueta parcialmente cargada)

Qué intentas averiguar:

• Funciona en incógnito y falla en el modo normal: cookies, caché, extensiones o estado local del navegador
• Falla en varios navegadores/dispositivos: build, deploy, backend o un crash del cliente que afecta a todos
• Falla solo para una cuenta: permisos, datos de usuario, roles/feature flags o una respuesta API específica

Ejemplo: si un fundador ve el dashboard en blanco tras iniciar sesión pero un compañero puede cargarlo, ya estás tendiendo hacia “específico de la cuenta”, no “sitio caído”.

Captura lo básico antes de cambiar nada

Buenas notas arreglan problemas más rápido que clicar frenéticamente.

Escribe lo que esperabas frente a lo que viste. “El dashboard debería mostrar mis proyectos” es accionable. “Está roto” no lo es.

Los detalles mínimos que ahorran horas después:

• URL exacta (cópiala desde la barra de direcciones)
• Hora en que ocurrió (incluye zona horaria si puedes)
• Qué esperabas vs qué pasó
• Dispositivo y navegador (Mac Chrome, iPhone Safari)
• Red (Wi‑Fi de casa, Wi‑Fi de la oficina, hotspot)

Haz una captura de pantalla aunque parezca “nada”. Una pantalla blanca, un spinner atascado y un encabezado faltante suelen apuntar a causas distintas.

Refresca una vez, y luego para. Los bucles de refresco rápido pueden activar límites de tasa, cerrar sesiones o cambiar el estado de la app.

Paso 1: Prueba en modo incógnito

El modo incógnito/privado es la forma más rápida de separar “mi navegador está confundido” de “la app está rota”. Parte con una sesión limpia.

Haz esto:

• Abre una ventana de incógnito/privada
• Pega la misma URL exacta
• Si la página requiere login, inicia sesión y repite la acción que lleva a la pantalla en blanco
• Anota lo que pasa (carga, se queda en blanco, parpadea y luego se queda en blanco)
• Copia cualquier mensaje de error exactamente

Cómo interpretar el resultado:

• Si funciona en incógnito, sospecha cookies (sesión mala), archivos en caché (JavaScript antiguo), valores en local storage o una extensión que interfiere.
• Si sigue en blanco en incógnito, no pierdas tiempo borrando cachés aún. Has aprendido que probablemente no son solo tus cookies existentes.

Paso 2: Prueba otro navegador (y otro dispositivo si puedes)

A continuación, prueba la misma URL en un navegador distinto. Algunos problemas de “página en blanco” son específicos de navegador incluso cuando el servidor está bien.

Mantén la prueba limpia: misma conexión, mismos pasos, sin cambios extras.

Un orden sencillo que funciona:

• Abre la página en un segundo navegador que no suelas usar
• Prueba una ventana privada en ese segundo navegador
• Revisa la página en tu teléfono
• Si es posible, prueba el teléfono en datos móviles (apaga el Wi‑Fi)

Patrones a observar:

• Falla solo en un navegador: extensión, almacenamiento bloqueado, activo en caché o rareza del navegador
• Falla en todos los navegadores del mismo portátil: menos probable que sea una rareza del navegador
• Funciona en datos móviles pero no en el Wi‑Fi de la oficina: VPN, filtrado DNS o firewall/proxy corporativo
• Falla en todos los dispositivos y redes: deploy/build/backend o un crash del frontend que golpea a todos

Lleva un registro de una línea para no quedar en bucle: “Chrome Mac (Wi‑Fi): en blanco. Safari Mac (Wi‑Fi): carga. iPhone (datos móviles): carga.”

Paso 3: Comprueba si solo afecta a una cuenta

Ahora elimina “mi cuenta” de la ecuación.

1. Cierra sesión y carga primero una página pública cualquiera (home, pricing, página de marketing). Si las páginas públicas funcionan pero el área de la app está en blanco tras iniciar sesión, el problema suele involucrar autenticación, permisos o una llamada API posterior al login.

2. Compara cuentas. Pide a un compañero que inicie sesión y cargue la misma página.

3. Si puedes, prueba con una cuenta de test nueva. Las cuentas nuevas suelen tener datos limpios, lo que ayuda a revelar si un registro de usuario está provocando el crash.

Lectura rápida del resultado:

• Funciona para otras cuentas, falla solo para la tuya: sesión/cookies, registro de usuario corrupto, bug de roles/permisos o una página que no soporta tus datos específicos
• Falla para varias cuentas: fallo compartido del backend/API, crash del frontend en una ruta común o un mal deploy
• Las páginas públicas cargan pero las páginas de la app están en blanco: flujo de auth o una petición posterior al login fallando

Ejemplo: si el dashboard está en blanco solo para una cuenta admin, un widget exclusivo de admin podría estar haciendo una llamada API que falla y tumba toda la página.

Si funciona en incógnito: cookies, caché y extensiones

Si en incógnito funciona, probablemente el servidor está bien. Concéntrate en lo que es diferente en tu navegador normal: sesión almacenada, archivos en caché, extensiones o ajustes de privacidad del navegador.

Empieza por lo pequeño. Arregla solo el dominio, no todo el navegador.

Soluciones seguras, en orden

Prueba un cambio a la vez y vuelve a probar después de cada uno:

• Borra los datos del sitio solo para tu dominio (cookies y local storage), luego vuelve a iniciar sesión
• Recarga forzada (recargar sin usar caché)
• Desactiva extensiones y vuelve a activarlas una por una para encontrar la culpable (ad blockers y bloqueadores de scripts son comunes)
• Desactiva temporalmente la protección estricta de rastreo para una prueba rápida, y luego vuelve a activarla
• Prueba un perfil de navegador nuevo (o modo invitado) para confirmar que está ligado a tu perfil habitual

Qué evitar:

• No "borrar todos los datos de navegación" como primer movimiento. Borra pistas útiles y te desconecta de todos lados.
• No modifiques el código de la app si en incógnito funciona. Probablemente estés persiguiendo la categoría de problema equivocada.

Una vez encuentres el disparador (una extensión, un reinicio de cookie, un ajuste de privacidad), anótalo. Ese detalle suele prevenir repeticiones.

Si falla en todas partes: probablemente un problema de servidor o build

Si está en blanco en incógnito, en otro navegador y en otro dispositivo, trátalo como un problema de la app hasta que se demuestre lo contrario.

Primero, descarta un caso de red cambiando la red (hotspot del teléfono en lugar del Wi‑Fi de la oficina). Si eso lo arregla, sospecha reglas de firewall, filtrado DNS, VPNs o proxies.

Luego separa “no se puede alcanzar el sitio” de “el sitio carga pero la app no renderiza”:

• Si el dominio no resuelve o no puedes cargar nada en absoluto, piensa en DNS, hosting o certificado.
• Si ves la estructura (encabezado/maquetación) pero el área principal está vacía, piensa en crash del frontend o fallo de API.

Después busca cambios recientes. Las pantallas en blanco suelen empezar justo después de un deploy, una actualización de variables de entorno, un cambio en el proveedor de auth o una edición de configuración hecha a toda prisa.

Si tienes acceso a logs, céntrate en la hora exacta en que lo reprodujiste. Pistas comunes:

• Pico de errores 500
• “Failed to fetch” o errores CORS
• Fallos en verificación de tokens/auth
• Variables de entorno faltantes durante el build
• Timeouts de base de datos o errores de conexión

Trampas comunes que hacen perder tiempo

Las páginas en blanco se sienten urgentes, así que la gente empieza a hacer todo a la vez. Ahí es cuando se pierde la señal.

Los mayores sumideros de tiempo:

• Bucles de refresco que no cambian nada y no enseñan nada
• Cambiar múltiples variables a la vez (borrar caché, cerrar sesión, desactivar extensiones, redeploy) de modo que no puedas saber qué importó
• Probar solo con tu cuenta admin y perder un fallo específico de rol o de datos de usuario
• Olvidar el último cambio real (deploy, plugin, actualización de env var, ajuste de auth)

Una regla útil: cambia una cosa, observa, anota.

Lista de verificación de 5 minutos para acotar el problema

Responde esto en orden y registra cada resultado:

• Prueba en incógnito: ¿carga en una ventana privada tras iniciar sesión otra vez?
• Prueba en otro navegador: ¿carga en un navegador diferente?
• Prueba de cuenta: ¿carga con otro usuario (o una cuenta de prueba nueva)?
• Prueba dispositivo/red: ¿carga en un segundo dispositivo o en otra red (el hotspot sirve)?
• Evidencia: ¿tienes la URL exacta, la marca temporal y una captura de pantalla?

Cómo actuar según el patrón:

• Funciona solo en incógnito: algo en tu navegador normal interfiere (cookies, caché, extensión, local storage)
• Falla en dos navegadores y dos redes: para las soluciones locales e investiga deploy/build/backend/frontend
• Falla solo en una cuenta: céntrate en datos de usuario, roles/permiso y registros límite

Cuando escales, envía hechos: la URL, la hora, las pruebas que hiciste, qué esperabas, qué viste y cualquier texto de error de la consola que puedas copiar.

Ejemplo: dashboard en blanco para un usuario vs para todos

Una situación común: las páginas de marketing cargan, pero el dashboard queda en blanco justo después del login.

Escenario A: solo una cuenta

Ves una pantalla blanca. En incógnito funciona. En otro navegador funciona.

Eso es un problema de estado local (cookie/sesión/bundle en caché/extensión) o algo ligado a la configuración de tu cuenta que la sesión normal lee de forma distinta. Para de probar cuando puedas reproducir el patrón de forma consistente y escala con la evidencia.

Escenario B: la mayoría de usuarios

Incógnito está en blanco. Un segundo navegador está en blanco. Otro dispositivo o un compañero ve lo mismo.

Eso apunta a un fallo de deploy/build/backend o a un crash del frontend en una ruta común. No envíes suposiciones. Envía una nota corta de reproducción:

• URL exacta y qué pantalla está en blanco
• Qué pruebas hiciste (incógnito, navegador, dispositivo) y los resultados
• Si es una cuenta o varias
• Cuándo empezó y qué cambió recientemente
• Captura de pantalla y cualquier texto de error de la consola

Pasos siguientes: escala con claridad (y cuándo traer a FixMyMess)

Si la página en blanco aparece en varios navegadores/dispositivos, trátalo como una interrupción. Prioriza velocidad y claridad, no más experimentos.

Escala inmediatamente si:

• Los nuevos registros no pueden completarse
• El inicio de sesión falla para muchos usuarios
• Checkout/pagos fallan
• La app está en blanco en múltiples dispositivos y redes
• El problema empezó justo después de un deploy o un cambio de variable de entorno

Pide tres cosas: qué está fallando, por qué empezó y qué se va a cambiar para arreglarlo (más cómo se verificará la corrección).

Si la app fue generada por herramientas como Lovable, Bolt, v0, Cursor o Replit, las pantallas en blanco suelen deberse a flujos de auth frágiles, secretos expuestos o falta de coincidencia en build/despliegue que solo aparecen en producción. En esos casos, un diagnóstico externo rápido puede ser más barato que adivinar durante un incidente. FixMyMess (fixmymess.ai) ofrece una auditoría de código gratuita y se centra en convertir prototipos generados por IA en software listo para producción, incluyendo reparación de lógica, endurecimiento de seguridad y preparación del despliegue.