Pantalla blanca en WordPress: causas y solución paso a paso

Respuesta corta: una pantalla blanca en WordPress casi siempre es un error de PHP que no se está mostrando, memoria agotada o una caché que guardó una página vacía. Mira primero el código HTTP con curl -I, después el log de errores (activa WP_DEBUG_LOG en wp-config.php) y desactiva plugins y tema hasta que vuelva. Si solo pasa con caché, vacíala.

Qué es la pantalla blanca de WordPress

La pantalla blanca en WordPress es una página vacía: fondo blanco, sin texto, sin menú, sin mensaje de error. En inglés se la conoce como «White Screen of Death» (WSOD), y así aparece en la lista oficial de errores comunes de WordPress.

Hasta WordPress 5.2 era la forma típica en que se manifestaba un error fatal de PHP. Desde entonces, WordPress suele interceptar esos errores y muestra «Ha habido un error crítico en esta web» (tienes una guía para ese mensaje). Aun así, la pantalla blanca sigue apareciendo en estos casos:

1. El error ocurre antes de que WordPress cargue su protección: un fallo de sintaxis en wp-config.php, en un plugin «must-use» (wp-content/mu-plugins) o en un drop-in como object-cache.php o advanced-cache.php.
2. La protección está desactivada con WP_DISABLE_FATAL_ERROR_HANDLER.
3. Memoria o tiempo de ejecución agotados de forma que PHP muere sin poder escribir nada.
4. El tema no genera nada: una plantilla vacía, un index.php del tema borrado o un constructor de páginas que falla en silencio.
5. La caché guarda una página vacía: un plugin de caché, la caché del servidor o la CDN se quedaron con una respuesta en blanco y la sirven a todos.
6. El navegador enseña su propia página en blanco ante un error 500 sin contenido.
7. Errores de JavaScript en webs que dependen de él para pintar (algunos constructores, temas headless): el HTML llega, pero el navegador no lo dibuja.

Cómo saber qué tipo de pantalla blanca tienes

Antes de tocar nada, haz estas comprobaciones: no toda pantalla blanca en WordPress tiene la misma causa. Te ahorran mucho tiempo.

1. Mira el código HTTP

curl -sI https://tuweb.com/ | head -n 1
curl -s https://tuweb.com/ | head -c 500

• 500: error de PHP o del servidor. Ve a los logs.
• 200 con cuerpo vacío o casi vacío: el tema no ha generado nada o la caché sirve una página vacía.
• 200 con HTML completo: el servidor funciona; el problema está en el navegador (JavaScript o CSS). Abre las herramientas de desarrollo (F12) y mira la pestaña Consola.

2. Prueba sin caché

Abre la web en una ventana privada añadiendo ?nocache=1 a la URL. Si así se ve bien, vacía la caché del plugin, del servidor y de la CDN.

3. Comprueba dónde pasa

• ¿Solo en /wp-admin/? Suele ser un plugin que carga código en el escritorio.
• ¿Solo en algunas páginas? Puede ser una plantilla concreta del tema, un shortcode o un bloque.
• ¿Solo en móvil? Revisa plugins de caché con versión móvil separada o el tema en su vista móvil.

Cómo arreglar la pantalla blanca en WordPress paso a paso

Paso 1: activa el registro de errores

Edita wp-config.php por FTP/SFTP, SSH o el gestor de archivos del panel y deja estas líneas antes de «¡Eso es todo, deja de editar!»:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Recarga la página y revisa wp-content/debug.log:

tail -n 50 wp-content/debug.log

Si no aparece nada, el error es anterior a WordPress o del servidor. Mira el log de PHP o del servidor web: en el panel suele estar en «Registros» o «Error log»; por SSH, en /var/log/apache2/error.log, /var/log/nginx/error.log o el log de PHP-FPM.

Para leer el error que encuentres, tienes nuestra guía de «Fatal error» y «Parse error» de PHP en WordPress.

Paso 2: comprueba wp-config.php

Un punto y coma que falta o unas comillas mal cerradas en wp-config.php dejan la web en blanco. Compruébalo:

php -l wp-config.php

Si dice «No syntax errors detected», está bien. Si no, te indica la línea. Revisa también que no haya espacios ni líneas en blanco antes de la etiqueta de apertura de PHP.

Paso 3: desactiva todos los plugins

Con wp-cli:

wp plugin deactivate --all --skip-plugins --skip-themes

Por FTP: renombra wp-content/plugins a plugins.off. Si la web vuelve, deja el nombre original y reactívalos uno a uno desde el escritorio hasta que reaparezca la pantalla blanca. El último que activaste es el culpable.

No olvides los mu-plugins y los drop-ins: renombra temporalmente wp-content/mu-plugins, wp-content/object-cache.php y wp-content/advanced-cache.php si existen. Una caché de objetos que apunta a un Redis o Memcached que ya no existe es una causa típica de página en blanco tras una migración.

Paso 4: cambia al tema por defecto

wp theme activate twentytwentyfour --skip-plugins --skip-themes

Por FTP, renombra la carpeta del tema activo en wp-content/themes; WordPress cambiará a otro tema instalado. Si la web vuelve, el problema está en el tema o en el tema hijo.

Paso 5: sube el límite de memoria

Si en el log aparece «Allowed memory size of … bytes exhausted», añade a wp-config.php:

define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

WP_MAX_MEMORY_LIMIT se aplica al escritorio. Si el hosting tiene un límite de PHP inferior, estas constantes no lo superan: pídeselo al proveedor o cámbialo en la configuración de PHP del panel.

Paso 6: vacía todas las cachés

Plugin de caché, caché del servidor (LiteSpeed, Varnish, Nginx FastCGI), caché de objetos y CDN. Si la web vuelve al purgar, revisa por qué se guardó una respuesta vacía: muchas veces la caché se generó justo durante un error.

Paso 7: si nada funciona, reinstala el núcleo

Sin tocar wp-content ni wp-config.php:

wp core verify-checksums
wp core download --force --skip-content

El primer comando compara los ficheros del núcleo con los oficiales y te dice si alguno se ha modificado o falta.

Errores habituales

• Restaurar una copia a ciegas. Funciona, pero sin saber la causa volverá con la próxima actualización.
• Ver la web bien porque estás logueado. Muchos plugins de caché no sirven caché a los administradores: tú ves la web y tus visitantes, la pantalla blanca. Comprueba siempre en una ventana privada.
• Dejar WP_DEBUG activado y el debug.log creciendo y accesible desde fuera.
• Olvidar los mu-plugins y los drop-ins al desactivar plugins.
• Cambiar la versión de PHP sin probar. Es una de las causas más comunes y se evita probando antes en un entorno de pruebas.

Para agencias: una página en blanco no es una caída

Lo peligroso de la pantalla blanca es que el servidor responde. Si devuelve un 200 vacío, un monitor que solo comprueba si la web contesta te dirá que todo va bien.

Jeffrey hace cada día una prueba con un navegador real, en móvil y en escritorio, sobre hasta cinco páginas de cada web. Si una página carga sin error pero tiene menos de 40 caracteres de texto visible y menos de tres enlaces, la marca como página en blanco. Antes de avisar repite la prueba a los cinco minutos, y si se confirma te manda un aviso urgente con la URL y el dispositivo. Si la pantalla blanca viene con un error 500 en la portada, la sonda de disponibilidad, que mira cada uno o dos minutos, abre además el aviso de caída tras tres muestras fallidas seguidas. Con el plugin de Jeffrey instalado, la prueba con navegador se repite un par de minutos después de cada actualización.

Si es urgente y no sabes por dónde empezar, escríbenos y lo miramos.

Tienes el resto de errores en la guía de errores de WordPress que tumban tu web.

Preguntas frecuentes