WordPress: Cómo solucionar el error 'White Screen of Death'
¿Has llegado a tu sitio web y te has encontrado con una pantalla completamente en blanco? Sin mensajes de error, sin nada. Solo un fondo blanco. No te preocupes, esto es más común de lo que crees y tiene solución. En el mundo del hosting y la administración de sistemas, este problema se conoce como el "White Screen of Death" (WSoD) o, en español, la pantalla blanca de la muerte. Es uno de los errores más temidos, pero también uno de los más fáciles de diagnosticar y solucionar si sigues los pasos adecuados.
En este artículo, vamos a desglosar las causas más comunes del WSoD WordPress y te daremos una guía paso a paso para solucionar WordPress cuando se queda en blanco. No necesitas ser un experto en SysAdmin WordPress, solo seguir estas instrucciones con calma. Vamos allá.
¿Qué es el White Screen of Death (WSoD) y por qué ocurre?
El error WordPress conocido como WSoD se produce cuando el servidor web (Apache, Nginx, etc.) no puede procesar correctamente el código PHP de tu sitio, o cuando se encuentra con un error fatal que impide que se ejecute cualquier script. Como resultado, el navegador recibe una respuesta vacía o incompleta, mostrando solo un fondo blanco.
Causas principales del WSoD:
- Límite de memoria PHP agotado: Es la causa más frecuente. Un plugin o tema mal optimizado consume toda la memoria asignada a PHP.
- Plugin o tema defectuoso: Una actualización fallida, un código incompatible o un plugin malicioso pueden romper la ejecución.
- Archivo .htaccess corrupto: Un archivo de configuración del servidor (Apache) dañado puede bloquear el acceso.
- Actualización de WordPress fallida: Si la actualización del core se interrumpe, puede dejar el sitio en un estado inconsistente.
- Problemas de permisos de archivos: Si los archivos de WordPress no tienen los permisos correctos, el servidor no puede leerlos.
- Error de sintaxis en archivos PHP: Un pequeño error tipográfico en
wp-config.phpo en el archivo de funciones de un tema puede provocar el bloqueo.
Paso 1: Activar el modo de depuración (Debug Mode)
Antes de hacer nada, intenta obtener más información. WordPress tiene un modo de depuración que muestra los errores PHP reales en lugar de una pantalla en blanco. Para activarlo, necesitas editar el archivo wp-config.php.
¿Cómo acceder al archivo wp-config.php?
- Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel de control (cPanel, DirectAdmin, o Syspanel, que se accede por el puerto 2106).
- Busca el archivo
wp-config.phpen la raíz de tu instalación de WordPress (normalmente enpublic_html/owww/). - Ábrelo con un editor de texto plano (no con Word, usa Notepad++ o similar).
- Busca la línea que dice:
define('WP_DEBUG', false); - Cámbiala por esto:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
[TIP] Si no encuentras la línea define('WP_DEBUG', false);, puedes añadir las tres líneas justo antes del comentario final /* That's all, stop editing! Happy publishing. */.
- Guarda el archivo y vuelve a cargar tu sitio web.
¿Qué verás ahora? En lugar de la pantalla en blanco, deberías ver un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size of 134217728 bytes exhausted..."). Este mensaje te dará la pista clave para saber qué está fallando (el plugin X, el tema Y, etc.).
Además, se creará un archivo de registro llamado debug.log en la carpeta wp-content/. Puedes descargarlo y revisarlo para ver todos los errores.
[WARNING] Una vez que hayas solucionado el problema, vuelve a desactivar el modo debug cambiando true a false en las tres líneas. Dejarlo activo en un sitio en producción puede exponer información sensible a los visitantes.
Paso 2: Desactivar todos los plugins
Si el mensaje de error no es claro o no aparece, el siguiente paso es desactivar todos los plugins. Esto descartará si el problema está en uno de ellos.
Forma 1: A través del panel de administración (si puedes acceder)
- Ve a
Plugins > Plugins instalados. - Selecciona todos los plugins.
- En el menú desplegable "Acciones en bloque", elige "Desactivar" y haz clic en "Aplicar".
Forma 2: A través de FTP o el administrador de archivos (si no puedes acceder al panel)
- Conéctate a tu servidor.
- Navega a la carpeta
wp-content/. - Renombra la carpeta
pluginsaplugins_desactivados(o cualquier otro nombre). - Vuelve a cargar tu sitio. Si ahora funciona, el problema está en algún plugin.
¿Cómo identificar el plugin problemático?
- Vuelve a renombrar la carpeta a
plugins. - Ve al panel de administración (si ya puedes acceder) y activa los plugins uno por uno, recargando el sitio después de cada activación.
- Cuando el sitio se rompa de nuevo, ¡has encontrado al culpable! Desactívalo y busca una alternativa o contacta al desarrollador.
Paso 3: Cambiar al tema por defecto (Twenty Twenty-Four o similar)
Si desactivar todos los plugins no soluciona el error WordPress, el siguiente sospechoso es el tema activo.
Forma 1: Desde el panel de administración (si puedes acceder)
- Ve a
Apariencia > Temas. - Activa un tema por defecto de WordPress (Twenty Twenty-Four, Twenty Twenty-Three, etc.).
Forma 2: A través de FTP o administrador de archivos
- Conéctate a tu servidor.
- Navega a
wp-content/themes/. - Renombra la carpeta de tu tema activo (por ejemplo,
mi-temaami-tema_desactivado). - WordPress automáticamente intentará usar un tema por defecto. Si no lo encuentra, puedes descargar uno desde el repositorio oficial y subirlo a la carpeta
themes. - Vuelve a cargar tu sitio. Si funciona, el problema es de tu tema. Contacta al desarrollador o restaura una copia de seguridad anterior del tema.
Paso 4: Aumentar el límite de memoria PHP
Si el error que viste en el Paso 1 mencionaba "Allowed memory size exhausted", necesitas aumentar el límite de memoria PHP.
¿Cómo hacerlo?
- Edita el archivo
wp-config.php(como en el Paso 1). - Añade la siguiente línea justo antes del comentario final:
define('WP_MEMORY_LIMIT', '256M');
- Guarda el archivo y recarga el sitio.
[INFO] Si tu hosting lo permite, también puedes aumentar el límite a través del archivo php.ini (si tienes acceso) o desde el panel de control. En Syspanel (puerto 2106), busca la sección "PHP Settings" o "Select PHP Version" y ajusta el valor de memory_limit. Normalmente, 128M o 256M son suficientes para la mayoría de sitios.
Paso 5: Verificar y reparar el archivo .htaccess
Un archivo .htaccess corrupto o mal configurado puede causar el WSoD WordPress, especialmente si usas un servidor Apache.
¿Cómo solucionarlo?
- Conéctate a tu servidor por FTP.
- Busca el archivo
.htaccessen la raíz de tu instalación (puede estar oculto; activa "Mostrar archivos ocultos" en tu cliente FTP). - Renómbralo a
.htaccess_old(esto lo desactiva). - Vuelve a cargar tu sitio. Si funciona, el problema era el
.htaccess. - Para regenerar uno nuevo, ve al panel de administración de WordPress (si ya puedes acceder) a
Ajustes > Enlaces permanentesy haz clic en "Guardar cambios". WordPress creará un nuevo.htaccesslimpio.
Paso 6: Verificar permisos de archivos y carpetas
Los permisos incorrectos pueden impedir que WordPress lea o escriba archivos, causando el error WordPress de pantalla blanca.
Los permisos correctos son:
- Carpetas: 755
- Archivos: 644
- Archivo
wp-config.php: 600 o 640
¿Cómo verificarlos?
- Conéctate a tu servidor por FTP.
- Haz clic derecho en la carpeta raíz de tu WordPress y selecciona "Permisos de archivos" (o "File Permissions").
- Aplica los valores mencionados (marca "Recursivo" para que se aplique a todas las subcarpetas y archivos).
[WARNING] No pongas permisos 777 a menos que sepas exactamente lo que haces, ya que es un grave riesgo de seguridad.
Paso 7: Reinstalar el núcleo de WordPress
Si nada de lo anterior funciona, es posible que algún archivo del núcleo de WordPress esté dañado.
¿Cómo reinstalar sin perder contenido?
- Descarga la última versión de WordPress desde wordpress.org.
- Descomprime el archivo en tu ordenador.
- Conéctate a tu servidor por FTP.
- Sube TODOS los archivos de la carpeta
wordpress(exceptowp-content/ywp-config.php) a tu servidor, sobrescribiendo los existentes. - Esto reemplazará los archivos del núcleo (wp-admin, wp-includes, etc.) sin tocar tus plugins, temas o la base de datos.
FAQ: Preguntas frecuentes sobre el WSoD
¿Puedo perder mis datos si soluciono el WSoD?
No. Siempre que no borres la base de datos ni la carpeta wp-content, tus entradas, páginas, comentarios y configuraciones están a salvo. Los pasos anteriores solo desactivan temporalmente plugins o temas.
¿Qué hago si ni siquiera puedo acceder al administrador de archivos?
Si no tienes acceso a FTP ni al panel de control, contacta a tu proveedor de hosting. Ellos pueden acceder al servidor y realizar estos pasos por ti. En el caso de Syspanel, recuerda que el acceso es por el puerto 2106.
¿El WSoD puede ser causado por un ataque de seguridad?
Sí, un sitio infectado con malware puede mostrar una pantalla blanca. Si después de seguir todos los pasos el problema persiste, revisa los archivos en busca de código sospechoso (por ejemplo, en wp-content/plugins/ o wp-content/themes/) o instala un plugin de seguridad como Wordfence.
¿Debo borrar la carpeta wp-content al reinstalar el núcleo?
Nunca. Ahí están tus plugins, temas y subidas (imágenes, PDFs, etc.). Borrarla eliminaría todo tu contenido personalizado.
¿Y si el error aparece solo en el panel de administración?
A veces el WSoD afecta solo al front-end (la web visible) o solo al back-end (el panel de administración). Si solo ves la pantalla blanca al entrar a /wp-admin, el problema suele ser un plugin o tema que se carga en el área de administración. Sigue los mismos pasos (desactivar plugins y cambiar tema).
Conclusión: No temas al WSoD
El White Screen of Death es un error que asusta, pero con un enfoque metódico y las herramientas adecuadas, se puede solucionar WordPress en cuestión de minutos. Recuerda:
- Activa el modo debug para obtener pistas.
- Desactiva todos los plugins.
- Cambia al tema por defecto.
- Aumenta la memoria PHP.
- Revisa el
.htaccessy los permisos. - Reinstala el núcleo de WordPress.
Si eres un SysAdmin WordPress o simplemente un usuario que quiere mantener su sitio sano, te recomiendo hacer una copia de seguridad completa (archivos y base de datos) antes de tocar nada. Así, si algo sale mal, puedes restaurar todo en segundos.
Y recuerda: si usas Syspanel, el acceso es por el puerto 2106, y desde allí puedes gestionar archivos, bases de datos y hasta ajustar la versión de PHP. ¡No te rindas! La pantalla blanca no es el fin del mundo, solo un pequeño obstáculo en el camino.
