La "pantalla blanca de la muerte" ocurre cuando su 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 ofrece ninguna pista visible sobre la causa. Esta guía repasa las causas más comunes y cómo solucionar cada una de ellas.
Paso 1: Revise el registro de errores
Lo primero que debe hacer es revisar el registro de errores PHP, que normalmente revela la causa exacta:
- Inicie sesión en KPanel en kpanel.kapsulehost.com
- Vaya a Sitios web, seleccione su sitio y haga clic en Registros
- Abra el Registro de errores PHP
- Busque entradas
Fatal errorcerca del momento en que comenzó la pantalla blanca
Consulte Cómo acceder a los registros de errores de su sitio web para más detalles.
Paso 2: Active el modo de depuración de WordPress
Si el registro de errores no muestra suficiente detalle, active el modo de depuración de WordPress:
- Conéctese mediante SFTP o el Gestor de archivos de KPanel
- Abra
wp-config.php - Configure lo siguiente:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
- Vuelva a cargar la página y revise
wp-content/debug.logpara ver el mensaje de error
Paso 3: Desactive todos los plugins
Un plugin defectuoso o incompatible es la causa más común de una pantalla blanca tras una actualización.
Si puede acceder al panel de administración de WordPress: vaya a Plugins > Installed Plugins, selecciónelos todos y elija Deactivate en el menú de acciones masivas.
Si no puede acceder al panel de administración de WordPress:
- Conéctese a su sitio mediante SFTP
- Vaya a
wp-content/plugins/ - Cambie el nombre de la carpeta
pluginsaplugins-disabled - Intente cargar el sitio
Si la pantalla blanca desaparece, un plugin es el culpable. Vuelva a cambiar el nombre de la carpeta a plugins y, a continuación, desactive los plugins de uno en uno hasta identificar el plugin causante.
Paso 4: Cambie a un tema predeterminado
Un tema dañado también puede causar una pantalla blanca:
- Mediante SFTP, vaya a
wp-content/themes/ - Cambie el nombre de la carpeta de su tema activo a algo como
mytheme-disabled - WordPress recurrirá a un tema predeterminado
Tras identificar el plugin o tema problemático, verifique si hay disponible una actualización del desarrollador. Muchos problemas de pantalla blanca se solucionan en la siguiente versión.
Paso 5: Aumente el límite de memoria de PHP
Una pantalla blanca puede producirse cuando WordPress se queda sin memoria. Para aumentar el límite:
- Abra
wp-config.phpen el Gestor de archivos o mediante SFTP - Añada esta línea antes de la línea
/* That's all, stop editing! */:
define( 'WP_MEMORY_LIMIT', '256M' );
- Guarde el archivo y vuelva a cargar el sitio
También puede aumentar el límite de memoria de PHP en KPanel, en Sitios web > [su sitio] > Configuración > PHP.
Paso 6: Restaure 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 la vía más rápida hacia la solución. Consulte Restaurar desde una copia de seguridad.
¿Sigue sin resolverse?
Si la pantalla blanca persiste después de seguir estos pasos, abra un ticket de soporte en KPanel, en Soporte. Incluya las entradas más recientes del registro de errores PHP y una descripción de lo que cambió en el sitio antes de que apareciera el problema.