Reparar la pantalla blanca de la muerte de WordPress

The "white screen of death" is when your WordPress site displays a blank white page with no error message. It is one of the more frustrating WordPress issues because it gives no visible clue about…

La "pantalla blanca de la muerte" ocurre cuando tu sitio WordPress muestra una página en blanco sin ningún mensaje de error. Es uno de los problemas de WordPress más frustrantes porque no da ninguna pista visible sobre la causa. Esta guía te lleva a través de las causas más comunes y cómo reparar cada una.

Paso 1: Revisar el Registro de Errores

Lo primero que debes hacer es revisar tu registro de errores de PHP, que generalmente revela la causa exacta:

Inicia sesión en KPanel en kpanel.kapsulehost.com
Ve a Websites, selecciona tu sitio y haz clic en Logs
Abre el PHP Error Log
Busca entradas Fatal error cerca de la hora en que comenzó la pantalla blanca

Consulta Accessing Your Website Error Logs para más detalles.

Paso 2: Activar el Modo de Depuración de WordPress

Si el registro de errores no muestra suficiente detalle, activa el modo de depuración de WordPress:

Conecta vía SFTP o el Gestor de Archivos de KPanel
Abre wp-config.php
Establece lo siguiente:

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

Recarga la página y revisa wp-content/debug.log para el mensaje de error

Paso 3: Desactivar Todos los Plugins

Un plugin defectuoso o incompatible es la causa más común de una pantalla blanca después de una actualización.

Si puedes acceder al administrador de WordPress: ve a Plugins > Installed Plugins, selecciona todos y elige Deactivate del menú de acciones en lote.

Si no puedes acceder al administrador de WordPress:

Conecta a tu sitio vía SFTP
Navega a wp-content/plugins/
Renombra la carpeta plugins a plugins-disabled
Intenta cargar el sitio

Si la pantalla blanca desaparece, un plugin es el culpable. Renombra la carpeta de nuevo a plugins, luego desactiva los plugins uno a uno hasta que identifiques el plugin problemático.

Paso 4: Cambiar a un Tema Predeterminado

Un tema roto también puede causar una pantalla blanca:

Vía SFTP, ve a wp-content/themes/
Renombra la carpeta de tu tema activo a algo como mytheme-disabled
WordPress volverá a un tema predeterminado

Después de identificar el plugin o tema problemático, verifica si hay una actualización disponible del desarrollador. Muchos problemas de pantalla blanca se solucionan en la siguiente versión.

Paso 5: Aumentar el Límite de Memoria de PHP

Una pantalla blanca puede ocurrir cuando WordPress se queda sin memoria. Para aumentar el límite:

Abre wp-config.php en el Gestor de Archivos o vía SFTP
Añade esta línea antes de la línea /* That's all, stop editing! */:

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

Guarda el archivo y recarga el sitio

También puedes aumentar el límite de memoria de PHP en KPanel bajo Websites > [your site] > PHP Settings.

Paso 6: Restaurar desde una Copia de Seguridad

Si ninguno de los pasos anteriores resuelve el problema, restaurar desde una copia de seguridad realizada antes de que comenzara el problema es el camino más rápido hacia la resolución. Consulta Restoring From Backup.

¿Aún No Resuelto?

Si la pantalla blanca persiste después de trabajar a través de estos pasos, abre un ticket de soporte en KPanel bajo Support. Incluye las entradas del registro de errores de PHP más recientes y una descripción de qué cambió en el sitio antes de que apareciera el problema.