Guía para solucionar el error 'white screen of death' en WordPress (cPanel)
¡Hola! Soy tu asistente técnico de confianza, y hoy vamos a desactivar uno de los errores más temidos por cualquier usuario de WordPress: la pantalla blanca de la muerte (White Screen of Death o WSOD). Si ves una página en blanco en tu web, sin ningún mensaje de error, no entres en pánico. Esto es mucho más común de lo que crees y, por lo general, tiene solución.
En esta guía extensa te voy a explicar paso a paso cómo solucionar la pantalla blanca en WordPress usando tu panel de control cPanel. También mencionaremos cómo hacerlo si usas Syspanel (el antiguo HestiaCP, cuyo acceso es por el puerto 2106), pero el enfoque principal será cPanel. Al final, tendrás una lista de verificación y una sección de preguntas frecuentes para que nunca más te asuste el temido white screen of death WordPress.
¿Qué es exactamente la pantalla blanca de la muerte?
La pantalla blanca WordPress cPanel es un error crítico que impide que tu sitio cargue cualquier contenido. El navegador muestra una página completamente en blanco, a veces con un título vacío. Esto ocurre porque PHP (el lenguaje en el que está escrito WordPress) se encuentra con un error fatal y no puede continuar ejecutándose. Las causas más comunes son:
- Un plugin o tema defectuoso.
- Límite de memoria de PHP agotado.
- Un archivo core de WordPress dañado.
- Conflictos de compatibilidad entre plugins.
- Un error en un archivo
.htaccess.
No te preocupes, porque la mayoría de estas causas tienen una solución directa desde el panel de control.
Paso 1: Accede a tu panel de control (cPanel o Syspanel)
Antes de tocar nada, necesitas entrar a tu hosting. Dependiendo de tu proveedor, será cPanel o Syspanel (HestiaCP). Si usas Syspanel, recuerda que la dirección de acceso es tudominio.com:2106 (por ejemplo, mipagina.com:2106). En cPanel, normalmente es tudominio.com/cpanel o una URL que te dio tu hosting.
[TIP] Si no sabes qué panel tienes, revisa el correo de bienvenida de tu hosting o contacta con soporte. Ambos son muy similares para tareas básicas.
Una vez dentro, busca la sección de Archivos o File Manager. Ahí podrás navegar por los archivos de tu sitio web.
Paso 2: Identifica la causa raíz del error
El primer paso para solucionar pantalla blanca WordPress es saber qué lo está provocando. No te lances a desactivar todo a lo loco. Sigue este orden lógico:
2.1. Activa el modo debug de WordPress
WordPress tiene un modo de depuración que muestra los errores reales en lugar de la pantalla blanca. Para activarlo, necesitas editar el archivo wp-config.php que está en la raíz de tu instalación.
- En el File Manager, busca la carpeta
public_html(owwwohtdocs). - Localiza el archivo
wp-config.php. - Haz clic derecho y selecciona Editar (o Code Editor).
- Busca la línea que dice
define('WP_DEBUG', false);. Si no existe, puedes añadirla justo antes de la línea que dice/* That's all, stop editing! Happy blogging. */. - Cambia
falseportruey añade estas dos líneas debajo:define('WP_DEBUG', true); define('WP_DEBUG_DISPLAY', true); - Guarda los cambios.
Ahora recarga tu web. En lugar de la pantalla blanca, verás un mensaje de error con detalles como "Fatal error: Uncaught Error..." o "Allowed memory size...". Ese mensaje te dará pistas clave.
[INFO] Si no ves nada, prueba a añadir también
define('WP_DEBUG_LOG', true);. Esto creará un archivodebug.logen la carpetawp-content. Puedes descargarlo y leerlo.
2.2. Revisa los logs de errores del servidor
Si el modo debug no te da información, consulta los logs de errores de PHP desde cPanel:
- En cPanel, busca la sección Errores o Error Log (a veces está dentro de Métricas).
- Abre el log más reciente. Busca líneas que contengan "PHP Fatal error" o "White Screen".
- Anota el archivo y la línea que causa el error (por ejemplo,
/wp-content/plugins/mi-plugin/mi-archivo.php).
En Syspanel, los logs suelen estar en /var/log/httpd/ o puedes verlos desde la opción Logs en el panel.
Paso 3: Soluciones rápidas según la causa
Una vez que tengas una idea de qué está fallando, aplica la solución correspondiente.
3.1. Si es un plugin el culpable
El error suele mencionar un archivo dentro de la carpeta wp-content/plugins/. Para desactivar el plugin sin entrar al panel de administración (que no funciona), hazlo manualmente:
- Ve a
public_html/wp-content/plugins/. - Busca la carpeta del plugin problemático (por el nombre que aparecía en el error).
- Cámbiale el nombre, por ejemplo, añadiendo
-desactivadoal final. Ej:mi-plugin-desactivado. - Recarga tu web. Si funciona, el plugin era el culpable. Luego puedes eliminarlo o actualizarlo.
Si no sabes qué plugin es, puedes desactivar todos a la vez:
- Renombra la carpeta
pluginsaplugins-desactivados. - Crea una nueva carpeta vacía llamada
plugins. - WordPress se ejecutará sin plugins. Si la web carga, ve activando uno por uno desde el panel de administración (renombrando la carpeta original a
pluginsde nuevo y moviendo los plugins de uno en uno).
[WARNING] No borres la carpeta original, solo renómbrala. Si renombras toda la carpeta
plugins, perderás la configuración de los plugins activos, pero no los datos.
3.2. Si es un tema el causante
Los temas también pueden provocar la pantalla blanca WordPress cPanel. Para desactivar el tema actual:
- Ve a
public_html/wp-content/themes/. - Busca la carpeta de tu tema activo (por ejemplo,
twentytwentyfouro el nombre que tengas). - Cámbiale el nombre (por ejemplo,
mi-tema-desactivado). - WordPress automáticamente usará un tema por defecto (Twenty Twenty-Four o similar). Si la web carga, el tema era el problema.
Si no tienes un tema por defecto, descarga uno desde wordpress.org y súbelo a la carpeta themes.
3.3. Si es un límite de memoria de PHP
El error suele decir "Allowed memory size of 134217728 bytes exhausted". Para aumentarlo:
- Edita el archivo
wp-config.php(como en el paso 2.1). - Añade esta línea antes de la línea final de comentarios:
define('WP_MEMORY_LIMIT', '256M'); - Guarda y recarga.
Si no funciona, también puedes modificar el archivo php.ini (si existe) o pedir a tu hosting que aumente el límite desde el panel. En cPanel, a veces hay una opción Select PHP Version > Switch to PHP Options donde puedes cambiar memory_limit.
3.4. Si es un archivo .htaccess corrupto
El archivo .htaccess puede dañarse y causar el error. Para restaurarlo:
- En el File Manager, busca el archivo
.htaccessenpublic_html. - Haz clic derecho y Descargar como respaldo.
- Luego, renómbralo a
.htaccess-viejo. - Ve a tu panel de administración de WordPress (si ya carga) y ve a Ajustes > Enlaces permanentes. Haz clic en Guardar cambios sin modificar nada. Esto regenerará un
.htaccessnuevo.
Si no puedes acceder al panel, crea un archivo nuevo en blanco llamado .htaccess y pégalo:
# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
Paso 4: Restaura archivos core de WordPress
A veces los archivos principales de WordPress se dañan. Para repararlos sin perder contenido:
- Descarga una copia fresca de WordPress desde wordpress.org (misma versión que tienes).
- Descomprímela en tu ordenador.
- Sube las carpetas
wp-adminywp-includesa tu servidor, sobrescribiendo las existentes. No toqueswp-contentniwp-config.php. - También puedes subir todos los archivos de la raíz excepto
wp-config.phpy la carpetawp-content.
Esto reemplazará archivos dañados sin tocar tus plugins, temas o medios.
Paso 5: Aumenta el límite de memoria desde cPanel (opción avanzada)
Si la solución anterior no basta, puedes aumentar el límite de memoria global de PHP:
- En cPanel, busca Select PHP Version.
- Haz clic en Switch to PHP Options.
- Busca
memory_limity cámbialo a256Mo512M. - Guarda.
En Syspanel, puedes editar el archivo /etc/php/8.x/apache2/php.ini (donde 8.x es tu versión de PHP) y cambiar memory_limit. Luego reinicia Apache o Nginx desde el panel.
[WARNING] No subas la memoria a valores excesivos (como 1024M) a menos que tu hosting lo permita. Podrías sobrecargar el servidor.
Preguntas frecuentes (FAQ)
¿Qué hago si después de todo sigo viendo la pantalla blanca?
Prueba a desactivar todos los plugins y temas manualmente (como en el paso 3). Si aún así no funciona, contacta con tu hosting. Puede ser un problema de configuración del servidor o de permisos de archivos.
¿Cómo sé si es un problema de PHP o de la base de datos?
Si la pantalla blanca aparece solo en algunas páginas o al hacer clic en un enlace, suele ser PHP. Si es en todo el sitio, puede ser la base de datos. Prueba a reparar la base de datos añadiendo esta línea a wp-config.php: define('WP_ALLOW_REPAIR', true); y luego visita tudominio.com/wp-admin/maint/repair.php. No olvides eliminar esa línea después.
¿Puedo evitar la pantalla blanca en el futuro?
Sí, siguiendo buenas prácticas:
- Actualiza WordPress, plugins y temas regularmente.
- Haz copias de seguridad semanales.
- Usa un plugin de caché y optimización.
- No instales plugins de fuentes no confiables.
- Monitorea los logs de errores.
¿El error afecta a mi SEO?
Sí, porque Google puede indexar la página en blanco si el error persiste. Soluciona rápido y, si tienes la web caída más de 24 horas, notifícalo en Search Console.
¿Qué hago si no tengo acceso a cPanel?
Si tu hosting no te da cPanel, pide acceso FTP o usa el gestor de archivos de tu panel (como Syspanel). El proceso es el mismo, solo cambia la interfaz.
Conclusión
La pantalla blanca de la muerte en WordPress no es el fin del mundo. Con esta guía, usando tu cPanel o Syspanel (puerto 2106), puedes diagnosticar y solucionar la pantalla blanca WordPress en pocos minutos. Recuerda siempre:
- Activar el modo debug.
- Desactivar plugins y temas manualmente.
- Aumentar la memoria si es necesario.
- Restaurar archivos core.
Si sigues estos pasos, tu web volverá a la vida. Y si te quedas atascado, no dudes en pedir ayuda a tu hosting o a un desarrollador. ¡Buena suerte y que tus páginas siempre carguen!
