Cómo solucionar 'White Screen of Death' en WordPress (pantalla blanca)
¿Te has encontrado con una página en blanco en tu WordPress, sin ningún mensaje de error, solo un vacÃo blanco? No te preocupes, no estás solo. Esto se conoce comúnmente como pantalla blanca wordpress o White Screen of Death (WSOD). Es uno de los errores más temidos, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.
En esta guÃa, te voy a explicar paso a paso, y de forma muy sencilla, cómo solucionar error wordpress de la pantalla blanca. No necesitas ser un experto en programación, solo seguir el orden lógico que te propongo. Vamos a ello.
¿Qué es exactamente la Pantalla Blanca de la Muerte?
Antes de lanzarnos a las soluciones, es importante entender qué está pasando. La white screen of death ocurre cuando PHP (el lenguaje en el que está escrito WordPress) encuentra un error fatal y se detiene por completo. No muestra el error en pantalla por configuración, asà que solo ves un lienzo en blanco.
Las causas más comunes son:
- Un plugin o tema con un conflicto de código.
- Falta de memoria PHP (lÃmite de memoria agotado).
- Archivos del núcleo de WordPress corruptos.
- Un archivo
.htaccessdañado. - Errores de sintaxis en el archivo
functions.phpde tu tema.
La buena noticia es que, en el 90% de los casos, el problema se resuelve con una de las primeras soluciones que te voy a dar. Vamos a ir de lo más simple a lo más complejo.
Paso 1: La Regla de Oro – Desactiva Todos los Plugins
Esta es la solución más efectiva y la primera que debes probar. La mayorÃa de las veces, la pantalla blanca wordpress es culpa de un plugin que ha decidido portarse mal.
¿Cómo desactivar plugins si no puedo entrar al panel?
Este es el truco que usamos los técnicos. No necesitas acceder a tu escritorio de WordPress. Usaremos un cliente FTP o el administrador de archivos de tu hosting.
- Conecta a tu servidor usando un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).
- Navega hasta la carpeta raÃz de tu instalación de WordPress (normalmente se llama
public_htmlowww). - Dentro, busca la carpeta
wp-content. - Dentro de
wp-content, busca la carpetaplugins. - Aquà está el truco: haz clic derecho sobre la carpeta
pluginsy selecciona "Renombrar". Cámbiale el nombre a algo comoplugins_DESACTIVADOS.
[WARNING]: Al renombrar la carpeta, WordPress no encontrará ningún plugin y los desactivará todos automáticamente. Es una solución drástica pero muy efectiva.
- Ahora, intenta cargar tu sitio web. Si la pantalla blanca desaparece, el problema era uno de tus plugins.
¿Y ahora qué hago con los plugins?
Genial, ya sabes que es un plugin. Ahora toca encontrar al culpable.
- Vuelve a renombrar la carpeta
plugins_DESACTIVADOSaplugins. (SÃ, tal cual, sin el sufijo). - Ve a tu panel de administración de WordPress (
/wp-admin). - Ve a "Plugins" → "Plugins instalados".
- ActÃvalos uno por uno. Después de activar cada uno, visita tu sitio web. Cuando la pantalla blanca aparezca de nuevo, ¡ese es el plugin problemático!
Una vez identificado, puedes eliminarlo o buscar una alternativa. Si necesitas desactivar solo uno sin entrar al panel, puedes borrar esa carpeta especÃfica dentro de wp-content/plugins/nombre-del-plugin.
Paso 2: Cambia al Tema por Defecto (Twenty Twenty-Four)
Si los plugins no eran el problema, el siguiente sospechoso es tu tema. Un error en el archivo functions.php de tu tema es una causa muy común de la white screen of death.
Acceso por FTP
- Vuelve a conectar por FTP.
- Ve a
wp-content/themes. - Verás las carpetas de tus temas instalados (ej.
twentytwentyfour,tu-tema-personalizado). - Renombra la carpeta de tu tema activo (el que estás usando) a algo como
tu-tema-personalizado_DESACTIVADO.
[TIP]: WordPress, al no encontrar tu tema, activará automáticamente uno de los temas por defecto (Twenty Twenty-Four, por ejemplo). Si la página carga bien, el problema es de tu tema.
Acceso desde el Panel (si puedes)
Si aún tienes acceso al panel de administración (a veces el error solo ocurre en la parte pública):
- Ve a "Apariencia" → "Temas".
- Activa un tema por defecto de WordPress (Twenty Twenty-Four).
- Si el error desaparece, el problema es de tu tema anterior.
En ese caso, tendrás que revisar el archivo functions.php de tu tema o contactar al desarrollador. A veces, simplemente actualizar el tema a la última versión soluciona el conflicto.
Paso 3: Aumenta el LÃmite de Memoria PHP
Otra causa muy frecuente es que WordPress se quede sin memoria. Si tu sitio tiene muchos plugins o un tema pesado, el lÃmite de memoria por defecto puede ser insuficiente.
Editando el archivo wp-config.php
Este es el archivo de configuración principal de WordPress. Ten mucho cuidado al editarlo.
- Conecta por FTP y busca el archivo
wp-config.phpen la raÃz de tu instalación. - Descárgalo y ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text).
- Busca la lÃnea que dice
/* ¡Eso es todo, deja de editar! Feliz blogging. */. - Justo antes de esa lÃnea, pega el siguiente código:
define( 'WP_MEMORY_LIMIT', '256M' );
- Guarda el archivo y súbelo de nuevo al servidor (reemplazando el original).
[INFO]: Este código aumenta el lÃmite de memoria a 256MB, que es un buen valor para la mayorÃa de los sitios. Si el problema persiste, puedes probar con 512M.
Paso 4: Revisa el Archivo .htaccess
El archivo .htaccess es un archivo de configuración del servidor. Si está corrupto, puede causar errores 500 o la pantalla blanca.
Restablecer el .htaccess
- Conecta por FTP y busca el archivo
.htaccessen la raÃz de tu WordPress. - Descárgalo a tu ordenador como copia de seguridad.
- Elimina el archivo
.htaccessdel servidor. - Ve a tu panel de administración de WordPress (si puedes) y navega a "Ajustes" → "Enlaces permanentes".
- Sin cambiar nada, haz clic en "Guardar cambios". Esto regenerará un archivo
.htaccesslimpio.
Si no puedes acceder al panel, simplemente deja el archivo eliminado. WordPress puede funcionar sin él, aunque la estructura de tus enlaces permanentes podrÃa verse afectada temporalmente.
Paso 5: Depuración de Errores de WordPress
WordPress tiene un modo de depuración que muestra los errores en pantalla. Esto es muy útil para saber exactamente qué está fallando.
Activar WP_DEBUG
- Abre tu archivo
wp-config.phpde nuevo. - Busca la lÃnea que dice
define( 'WP_DEBUG', false );. - Cámbiala por:
define( 'WP_DEBUG', true );
También puedes añadir estas lÃneas para que los errores se guarden en un archivo de registro en lugar de mostrarse en pantalla:
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
- Guarda el archivo y súbelo.
- Ahora, carga tu sitio web. En lugar de una pantalla blanca, verás un mensaje de error especÃfico, como "Error fatal: Llamada a una función no definida...". Este mensaje te dirá exactamente qué archivo y lÃnea está causando el problema.
[WARNING]: Una vez que hayas solucionado el error, vuelve a poner WP_DEBUG en false. Tener la depuración activa en un sitio en producción puede exponer información sensible a los visitantes.
Paso 6: Reinstala WordPress (Archivos del Núcleo)
Si nada de lo anterior funciona, es posible que los archivos del núcleo de WordPress estén dañados o incompletos.
Reinstalación manual
- Descarga la última versión de WordPress desde
wordpress.org. - Descomprime el archivo en tu ordenador.
- Conecta por FTP a tu servidor.
- IMPORTANTE: No borres las carpetas
wp-contentni el archivowp-config.php. Son tu contenido y configuración. - Sube el contenido de la carpeta descomprimida a la raÃz de tu instalación, sobrescribiendo los archivos existentes (excepto
wp-contentywp-config.php).
Esto reemplazará todos los archivos del núcleo con versiones limpias, sin tocar tus plugins, temas o contenido.
Paso 7: Revisa el Error en el Registro de PHP (Server Log)
Si has llegado hasta aquÃ, es hora de mirar los registros del servidor. Ahà se guardan todos los errores de PHP.
Cómo acceder a los logs
- cPanel: Busca la sección "Métricas" o "Registros" y haz clic en "Errores". Ahà verás los últimos errores registrados.
- Syspanel: Si tu hosting usa Syspanel (recuerda que el puerto de acceso es el 2106), busca una sección de "Registros" o "Logs" en el menú lateral. Normalmente hay un visor de errores de error_log.
- Por FTP: Muchas veces, el archivo de errores se llama
error_logy se encuentra en la raÃz de tu sitio o en la carpetawp-admin.
Abre el archivo de log y busca los errores más recientes. Te darán una pista muy valiosa sobre el origen del problema.
Preguntas Frecuentes (FAQ)
¿Puedo evitar que esto vuelva a pasar?
SÃ, en gran medida. Mantén siempre WordPress, tus plugins y temas actualizados. Usa plugins de calidad y no sobrecargues tu sitio con demasiados. Realiza copias de seguridad periódicas para poder restaurar tu sitio rápidamente si algo falla.
¿Qué hago si el error es en un plugin de caché?
Los plugins de caché a veces guardan versiones "rotas" de tus páginas. Si sospechas de uno, en el paso 1, al desactivarlos todos, se borra la caché. Al activarlos de nuevo, el problema se habrá solucionado.
¿Y si no tengo acceso a FTP ni al panel?
Algunos hostings ofrecen un "Administrador de Archivos" en su panel de control (como cPanel o Syspanel, cuyo puerto es el 2106). Puedes usarlo para renombrar carpetas o editar archivos sin necesidad de FTP. Si tu hosting no tiene esto, contacta con su soporte técnico; ellos pueden hacer los cambios por ti.
¿La pantalla blanca puede dañar mi sitio?
No, es un error temporal. No daña tu base de datos ni tu contenido. Simplemente "esconde" tu sitio hasta que se solucione. Tus datos están a salvo.
¿Por qué veo la pantalla blanca solo en el panel de administración?
Esto suele indicar un problema con un plugin o tema que se carga solo en el área de administración. Aplica el Paso 1 (desactivar plugins) para aislar el problema.
Recuerda, la clave está en la paciencia y en seguir los pasos en orden. La mayorÃa de las veces, el problema se resuelve con el primer paso (desactivar plugins). Si has llegado hasta el final, es muy probable que ya hayas encontrado la solución a tu pantalla blanca wordpress. ¡No te rindas!
