Introducción a la Pantalla Blanca de la Muerte (WSoD) en WordPress
Uno de los errores más temidos por los administradores de sitios web es la llamada Pantalla Blanca de la Muerte (White Screen of Death - WSoD). Este problema hace que tu sitio web de WordPress muestre una página completamente en blanco, tanto en el frontend como en el panel de administración (wp-admin), sin ofrecer ningún mensaje de error visible para el usuario.
Principales causas de la Pantalla Blanca de la Muerte
Este fallo suele estar relacionado con errores en el código PHP, agotamiento de los recursos del servidor o conflictos entre los componentes instalados. Las causas más comunes incluyen:
- Incompatibilidad o error fatal en un plugin recién instalado o actualizado.
- Conflictos en el archivo
functions.phpdel tema activo. - Agotamiento del límite de memoria asignado a PHP (Memory Limit).
- Problemas con la versión de PHP ejecutada en el servidor.
Método 1: Activar el Modo de Depuración (WP_DEBUG)
Para saber exactamente qué está causando el problema, el primer paso es activar el modo de depuración de WordPress. Esto revelará el mensaje de error real en lugar de la pantalla en blanco.
- Conéctate a tu servidor mediante un cliente FTP o utilizando el Administrador de Archivos de tu proveedor de hosting.
- Busca la carpeta raíz de tu instalación de WordPress y localiza el archivo
wp-config.php. - Descarga una copia de seguridad del archivo y luego ábrelo con un editor de código como Notepad++ o VS Code.
- Busca la línea que dice
define('WP_DEBUG', false);(si no existe, puedes crearla). - Modifica el valor a
trueañadiendo además las siguientes líneas para registrar los errores:
define('WP_DEBUG', true);define('WP_DEBUG_DISPLAY', true);
- Guarda los cambios y vuelve a cargar tu página web. Ahora verás el error específico y el archivo que lo provoca.
Método 2: Desactivar Plugins defectuosos vía FTP
Si el modo de depuración te indica que el error proviene de un plugin, o si sospechas de alguno instalado recientemente, puedes desactivarlos todos sin acceder al panel de administración.
- Accede a tu servidor mediante FTP o el Administrador de Archivos del hosting.
- Navega hasta la ruta
/wp-content/. - Renombra la carpeta llamada
pluginsa algo comoplugins_desactivados. - Visita tu sitio web. Si la pantalla blanca ha desaparecedo, significa que uno de tus plugins causaba el conflicto.
- Vuelve a renombrar la carpeta como
plugins. - Entra a tu panel de administración de WordPress y ve a la sección de Plugins. Actívalos uno por uno (renombrando sus carpetas individuales si es necesario) hasta dar con el responsable exacto para eliminarlo o actualizarlo.
Método 3: Aumentar el Límite de Memoria de PHP
Si tu sitio web se queda sin memoria durante la ejecución de scripts pesados, WordPress puede mostrar la pantalla blanca. Puedes incrementar este límite fácilmente.
- Abre nuevamente el archivo
wp-config.phpen la raíz de tu sitio. - Busca la línea que indica el inicio de la configuración y añade justo antes de
/* ¡Eso es todo, deja de editar! Feliz publicación */el siguiente código:
define('WP_MEMORY_LIMIT', '256M');
- Guarda los cambios y actualiza tu sitio web para comprobar si el problema se ha resuelto de forma definitiva.