No hay nada peor que navegar a tu sitio de WordPress y encontrarse de repente con la Pantalla Blanca de la Muerte (WSoD). Este error hace que tu sitio web sea inaccesible tanto para los administradores como para los visitantes.

La WSoD también puede ser increíblemente frustrante, debido a la falta de información que apunte a una posible causa o solución. Sin embargo, también es uno de los errores más comunes de WordPress. Así que aunque es preocupante, en la mayoría de los casos se puede resolver.

En este post, explicaremos qué es la WSoD de WordPress y cuáles son sus causas comunes. Y lo más importante, te guiaremos a través de nueve soluciones potenciales para que tu sitio vuelva a funcionar lo más rápido posible.

¡Empecemos!

¿Qué es la pantalla blanca de la muerte de WordPress?

Fiel a su nombre, la Pantalla Blanca de la Muerte de WordPress (también conocida como «WSoD») se produce cuando, en lugar de la página web a la que intentas acceder, te encuentras con una pantalla blanca en blanco en su lugar.

Dependiendo del navegador que estés usando, podrías obtener diferentes mensajes de error. A continuación se muestra un ejemplo en Google Chrome, que incluye una advertencia de error HTTP 500: «Esta página no funciona y no puede gestionar la solicitud»:

La pantalla blanca de la muerte de WordPress en Google Chrome
La pantalla blanca de la muerte de WordPress en Google Chrome

Ahora echemos un vistazo a la Pantalla Blanca de la Muerte en Mozilla Firefox:

El WSoD de WordPress en Mozilla Firefox
El WSoD de WordPress en Mozilla Firefox

Como puedes ver, es sólo una simple pantalla blanca. No contiene ningún error útil ni mensajes de advertencia.

La pantalla blanca de la muerte de WordPress casi siempre es causada por errores en el código PHP o por el agotamiento del límite de la memoria.

Otra posible causa es un tema o plugin defectuoso. Este último es probablemente el problema si el frontend del sitio web está caído, pero su área de administración de WordPress está levantada. Para comprobar rápidamente si el panel de control de tu sitio funciona, simplemente navega a yourdomain.com/wp-admin.

Entonces, ¿cómo arreglas el WSoD? ¡Me alegra que lo preguntes!

¿Cómo arreglar la pantalla blanca de la muerte de WordPress? (9 métodos)

Cuando experimentes la pantalla blanca de la muerte de WordPress, tu prioridad será arreglarla lo más rápido posible. Con eso en mente, veamos nueve posibles soluciones que puedes usar para resolverla.

1. Deshabilitar los plugins de WordPress

Una de las formas más fáciles y comunes de arreglar el WSoD de WordPress es simplemente deshabilitar todos los plugins. A menudo, un sitio se cae debido a una mala actualización de los plugins.

Si todavía puedes acceder a tu área de administración, una forma rápida de hacerlo es navegar a Plugins desde el panel de control, seleccionar todos los plugins y luego hacer clic en Desactivar en el menú desplegable Acciones masivas:

La configuración de Desactivar todos los plugins de WordPress
La configuración de Desactivar todos los plugins de WordPress

Esto deshabilitará todos los plugins.

Si eso arregla el problema, tendrás que encontrar al culpable. Para ello, puedes empezar a activar los plugins uno por uno, recargando el sitio después de cada activación. Cuando tu frontend se caiga, habrás encontrado el plugin de mal comportamiento.

Puedes entonces contactar con el desarrollador del plugin para pedir ayuda o publicar un ticket de soporte en el directorio de plugins de WordPress.

Si no puedes acceder a tu panel de control, puedes utilizar un cliente de Protocolo de Transferencia de Archivos (FTP) para acceder al directorio de archivos de tu sitio.

Bajo la carpeta wp-content de tu directorio raíz, localiza la carpeta de plugins. Renómbrala a algo parecido a «plugins_viejo»:

Renombra tu carpeta de plugins
Renombra tu carpeta de plugins

Entonces, revisa tu sitio de nuevo en la parte frontend. Si esto funciona, tendrás que probar cada plugin uno por uno. Renombra tu carpeta de plugins a «plugins», y luego renombra individualmente cada carpeta de plugins dentro de ella hasta que encuentres la defectuosa.

2. Cambiar a un tema predeterminado de WordPress

Si el problema no es un plugin, tu tema de WordPress puede ser la causa de la Pantalla Blanca de la Muerte. Para ver si este es el problema, puedes reemplazar tu tema cambiando a uno predeterminado.

Si puedes acceder a tu área de administración, ve a Apariencia > Temas en tu panel de control. Localiza y activa un tema predeterminado de WordPress como  Twenty Twenty:

El tema de Twenty Twenty WordPress.
El tema de Twenty Twenty WordPress.

Entonces, prueba tu sitio de nuevo. Si funciona, sabrás que el problema radica en tu tema.

Si no puedes acceder a tu tablero de mandos, el proceso es el mismo que con los plugins.

Usa el FTP para acceder a los archivos de tu sitio, y renombra tu carpeta wp-content/themes a otra cosa:

Cambie el nombre de su carpeta de temas
Cambia el nombre de tu carpeta de temas

WordPress volverá al último tema predeterminado, que probablemente sea Twenty Twenty. Si no tienes ningún otro tema, puedes descargar uno del directorio de temas de WordPress y luego subirlo a tu carpeta de temas.

Después de eso, adelante y compruebe su sitio de nuevo. Si funciona, tal vez su tema ha tenido un conflicto o una mala actualización. Si este es el caso, puede que necesite pedir ayuda al desarrollador o considerar cambiar de tema.

3. Borrar el navegador y la caché del plugin de WordPress

Si tienes acceso al backend de tu sitio WordPress pero sigues viendo el WSoD en el frontend, puede ser debido a un problema con tu caché.

Para arreglarlo, intenta limpiar la caché de tu navegador y el plugin de caché de WordPress (suponiendo que tengas uno instalado).

Si tienes un plugin de cacheo instalado en tu sitio de WordPress, como WP Rocket o WP Super Cache, la mayoría ofrece una forma rápida de borrar el cacheo a través de la página de configuración del plugin.

Usando WP Super Cache como ejemplo, en tu panel de control de WordPress navegarías a Ajustes > WP Super Cache > Borrar Cache:

La página de configuración del plugin WP Super Cache
La página de configuración del plugin WP Super Cache

¿Cómo limpiar tu caché de MyKinsta?

Si eres usuario de Kinsta, también hay una forma fácil de vaciar tu caché usando MyKinsta. Para ello, entra en tu cuenta. Haz clic en Herramientas, y luego en Borrar la caché en la sección Caché del sitio:

La opción de borrar la memoria caché en MyKinsta
La opción de borrar la memoria caché en MyKinsta

Una vez que vacíes la caché, guarda los cambios. Luego vuelve a visitar tu sitio para ver si eso corrigió el problema. Si no, es hora de pasar a otra solución.

4. Enciende el modo de depuración

Si todavía estás viendo la pantalla blanca de la muerte de WordPress, el área de administración no funciona, o crees que has encontrado el problema pero quieres profundizar más, puedes activar el modo de depuración. Esto mostrará cualquier error que esté ocurriendo en tu sitio web.

Para habilitar la depuración, necesitarás abrir el archivo wp-config.php de tu instalación de WordPress. Dentro de él deberías encontrar la siguiente línea:

define( 'WP_DEBUG', false );

Cambia «falso» por «verdadero», y luego recarga tu sitio. Si esta línea no existe, puedes agregarla a la parte superior del archivo.

En lugar de la pantalla blanca, obtendrás una pantalla blanca y algunos mensajes de error. Esto no es una gran mejora, pero es sólo un comienzo. El mensaje de error del WSoD debería indicar en qué archivo se originó el problema, así:

Cannot redeclare get_posts() (previously declared in 
/var/www/html/wordpress/wp-includes/post.php:1874) in 
/var/www/html/wordpress/wp-content/plugins/my-test-plugin/my-test-plugin.php on line 38

Puedes ver al final de este mensaje de ejemplo que el problema está en la línea 38 de un plugin llamado my-test-plugin. Por lo tanto, desactivando ese plugin deberías resolver el problema.

Si no ves ningún error después de activar el modo de depuración, es posible que necesites comunicarse con tu host. Es posible que la depuración no esté configurada correctamente en tu servidor.

Los clientes de Kinsta tienen la opción de usar una herramienta de depuración incorporada. Desde el panel de control de MyKinsta, haz clic en el nombre de tu sitio web y después en  Herramientas. En la depuración de WordPress, selecciona Activar:

¿Cómo habilitar el modo de depuración de WordPress en MyKinsta?
¿Cómo habilitar el modo de depuración de WordPress en MyKinsta?

A continuación, puedes acceder a tu registro de errores en la sección de registros de tu panel de control de MyKinsta y explorarlos para aprender más sobre el problema.

Ten en cuenta que tener activado el modo de depuración puede exponer parte de la información de tu sitio web a usuarios no autorizados. Por lo tanto, asegúrate de desactivar siempre el modo cuando termines de usarlo.

5. AumentA el límite de su memoria

Si todavía ves la temida página vacía del WSoD después de probar algunas de las soluciones anteriores, o si obtienes un error quejándote de los límites de memoria o de la memoria agotada, tendrás que asignar más memoria a la aplicación.

Esto se puede hacer a través del archivo wp-config.php en muchas instalaciones de WordPress. Abre el archivo y añade el siguiente código:

define('WP_MEMORY_LIMIT', '64M');

Si esto no parece funcionar, tienes algunas opciones. En un entorno normal, puedes usar tu archivo .htaccess para aumentar el límite de memoria. Simplemente añade la siguiente línea:

php_value memory_limit 64M

Si no puedes acceder a tu archivo .htaccess, puedes usar tu archivo php.ini para aumentar el límite de memoria en su lugar.

Para ello, conéctate a tu servidor por FTP. En el directorio raíz de tu sitio, busca el archivo php.ini. Una vez que lo localices, añade la siguiente línea en cualquier parte del archivo:

memory_limit = 64M

Si todavía no tienes memoria y necesitas asignar más, puede que haya un problema en tu solicitud. Tal vez tu tema o uno de tus plugins esté usando una cantidad desmesurada de recursos.

En este punto, puede que quieras contratar a un promotor para que eche un vistazo. Incluso tu host puede ayudarte, mostrándote los registros SQL y otras estadísticas de recursos de tu sitio.

6. Revisar los problemas de permiso de archivo

Otra posible causa de la WSoD son las cuestiones de permiso y propiedad. Puedes solucionar este problema tú mismo. Sin embargo, a menos que realmente sepas lo que estás haciendo, te desaconsejamos que lo hagas, ya que puedes crear inadvertidamente vulnerabilidades que los atacantes pueden explotar.

Cuando se trata de los permisos de WordPress, hay tres reglas simples a seguir:

  • Los archivos deben estar configurados en 664 o 644.
  • Las carpetas deben estar configuradas a 775 o 755.
  • El archivo wp-config.php debe estar configurado en 660, 600 o 644.

Si tienes acceso SSH a tu servidor, puedes aplicar las reglas apropiadas con el siguiente comando, ejecutándolo desde el directorio raíz de WordPress:

sudo find . -type f -exec chmod 664 {} +
sudo find . -type d -exec chmod 775 {} +
sudo chmod 660 wp-config.php

Si no estás seguro de cómo hacerlo o te sientes un poco intimidado, adelante y pide ayuda de tu host.

7. Comprueba si hay problemas de actualización automática que hayan fallado

A veces WordPress tiene un problema con las actualizaciones, como cuando el servidor se agota. La mayoría de las veces, este problema se resuelve automáticamente. Sin embargo, en algunos casos raros, puede llevar a la pantalla blanca de la muerte de WordPress.

Lo primero que debes hacer es ir al directorio raíz de WordPress y ver si hay un archivo .maintenance allí (el nombre del archivo puede ser abreviado también).

Lo que querrías hacer es intentar borrar ese archivo y cargar tu sitio de nuevo.

Si la actualización tuvo éxito, pero WordPress no eliminó este archivo automáticamente, todo debería volver a la normalidad.

Si la actualización no se completó, puede ser reiniciada automáticamente, en cuyo caso las cosas deberían volver a la normalidad de todos modos.

Si todo lo demás falla, sigue el procedimiento de actualización manual recomendado para WordPress, que debería resolver el problema de una vez por todas.

8. Resolver errores de sintaxis o restaurar una copia de seguridad

Otra causa común para el WSoD de WordPress es cuando estás editando el código de tu sitio de WordPress y accidentalmente escribes algo mal o usas la sintaxis equivocada.

Un personaje en el lugar equivocado podría derribar todo tu sitio, por lo que nunca debes editar el código de tu sitio de producción en vivo.

No hay que preocuparse, sin embargo. Siempre puedes conectarte a tu sitio por FTP y revertir el cambio que hiciste manualmente. Si no sabes qué cambio causó el problema, aquí es donde es útil tener copias de seguridad de WordPress.

Aquí en Kinsta, puedes restaurar tu sitio a un punto anterior en el tiempo con un solo clic. Para ello, inicia sesión en tu panel de control de MyKinsta y navega a Copias de seguridad:

La función de copia de seguridad en MyKinsta
La función de copia de seguridad en MyKinsta

Ten en cuenta que si se habilitó el modo de depuración en WordPress anteriormente, también puede haber un mensaje de error que indique un error de sintaxis de análisis. Si este es el caso, debería decirte exactamente dónde encontrar el código del problema.

9. Aumentar la capacidad de procesamiento de textos de PHP

En este punto, si la WSoD no se ha resuelto todavía, hay un truco adicional que puedes intentar. En raras ocasiones, este problema puede ocurrir debido a que una página o un post es particularmente largo.

Si este es el caso, puedes intentar ajustar la capacidad de procesamiento de texto PHP en tu sitio, aumentando los límites de retroceso y recursividad. Para ello, pega el siguiente código en tu archivo wp-config.php:

/* Trick for long posts /
ini_set('pcre.recursion_limit',20000000);
ini_set('pcre.backtrack_limit',10000000);

Una vez que añadas este código, guarda los cambios. Luego actualiza tu sitio para ver si ahora funciona.

Resumen

La pantalla blanca de la muerte de WordPress puede ser increíblemente frustrante, incluso aterradora. Hay un número de cosas que pueden salir mal, pero afortunadamente la situación no es tan mala como parece.

Un simple plugin y/o chequeo de tema debería arreglar el problema de WSoD en la mayoría de los casos. Familiarizarse con el modo de depuración de WordPress definitivamente arrojará más luz sobre el problema y te guiará.

Si te has encontrado con alguna otra situación de la pantalla blanca de la muerte de WordPress, háznoslo saber para que podamos aprender de ella y compartir la experiencia!

Daniel Pataki

Hi, my name is Daniel, I'm the CTO here at Kinsta. You may know me from Smashing Magazine, WPMU Dev, Tuts+ and other WordPress/Development magazines. Aside from WordPress and PHP I spend most of my time around Node, React, GraphQL and other technologies in the Javascript space.

When not working on making the best hosting solution in the Universe I collect board games, play table football in the office, travel or play guitar and sing in a pretty bad band.