Resolver la pantalla blanca de la muerte en WordPress: una guía completa

Publicado: 2024-05-16

Experimentar una “pantalla blanca de la muerte en WordPress” puede ser un problema desalentador para los propietarios de sitios web. Este problema, a menudo denominado "Pantalla blanca de la muerte" (WSOD), deja su sitio inaccesible y en blanco, lo que provoca pánico entre quienes no están familiarizados con la solución de problemas.

En esta guía completa, lo guiaremos a través de los pasos para diagnosticar y arreglar la pantalla blanca en WordPress, asegurando que su sitio vuelva a estar en línea rápidamente.


Entendiendo la pantalla blanca de la muerte

La pantalla blanca en WordPress normalmente ocurre cuando un script en su sitio web agota el límite de memoria. Sin embargo, otros problemas también pueden desencadenar este problema, como por ejemplo:

  • Conflictos de complementos o temas
  • Límites de memoria agotados
  • Problemas del servidor
  • Archivos principales corruptos

Comprender estas posibles causas le ayudará a diagnosticar y resolver mejor el problema.


Diagnóstico de la pantalla blanca en WordPress

Antes de profundizar en las soluciones, es fundamental diagnosticar la causa raíz de la pantalla blanca. Aquí hay algunos pasos iniciales a seguir:

  1. Verificar todas las páginas : determine si la pantalla blanca afecta a todas las páginas o solo a secciones específicas de su sitio, como el área de administración o una publicación en particular.
  2. Deshabilitar complementos y temas : desactivar todos los complementos y cambiar a un tema predeterminado (como Twenty Twenty-One) puede ayudar a identificar si un complemento o tema específico está causando el problema.
  3. Habilitar el modo de depuración : WordPress tiene una función de depuración incorporada que proporciona mensajes de error para ayudar a identificar el problema. Agregue las siguientes líneas a su archivo wp-config.php :

    define('WP_DEBUG', true);
    define('WP_DEBUG_LOG', true);
    define('WP_DEBUG_DISPLAY', false);

    Esto registrará los errores en un archivo debug.log en su directorio wp-content .

Arreglando la pantalla blanca en WordPress

Una vez que haya identificado las causas potenciales, puede comenzar a solucionar problemas específicos. Aquí hay algunos pasos detallados para resolver la pantalla blanca en WordPress:

1. Límite de memoria creciente

La memoria agotada es una causa común de la pantalla blanca. Para aumentar su límite de memoria PHP, agregue la siguiente línea a su archivo wp-config.php :

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

Si esto no funciona, es posible que necesites aumentar el límite de memoria en el archivo php.ini o .htaccess de tu servidor:

  • php.ini : memory_limit = 128M
  • .htaccess : php_value memory_limit 128M

2. Desactivar todos los complementos

Los complementos suelen ser los culpables de la pantalla blanca. Para desactivar rápidamente todos los complementos, cambie el nombre del directorio plugins en su carpeta wp-content a través de FTP o su administrador de archivos de alojamiento:

  1. Navega hasta wp-content .
  2. Cambie el nombre de la carpeta plugins a plugins_old .

Si esto resuelve el problema, cambie el nombre de la carpeta a plugins y reactive cada complemento uno por uno para identificar el problemático.

3. Volver a un tema predeterminado

Un tema defectuoso también puede provocar la pantalla blanca. Para cambiar a un tema predeterminado, cambie el nombre del directorio de su tema activo en wp-content/themes :

  1. Navegue hasta wp-content/themes .
  2. Cambie el nombre de la carpeta de su tema activo (por ejemplo, mytheme_old ).

WordPress volverá automáticamente a un tema predeterminado si está instalado. Si esto soluciona el problema, verifique si su tema tiene errores o considere usar un tema diferente.

4. Habilitación de registros de errores y depuración

Como se mencionó, habilitar la depuración en su archivo wp-config.php puede proporcionar información sobre la causa de la pantalla blanca. Revise el archivo debug.log ubicado en el directorio wp-content para ver mensajes de error y resuelva los problemas indicados.

5. Restaurar una copia de seguridad

Si tiene copias de seguridad recientes, restaurar su sitio a un estado anterior puede resolver rápidamente la pantalla en blanco. Asegúrese de realizar copias de seguridad periódicas de su sitio para evitar la pérdida de datos y facilitar la recuperación.

6. Comprobación de archivos principales dañados

Los archivos principales de WordPress dañados también pueden provocar una pantalla en blanco. Para solucionar este problema, descargue una copia nueva de WordPress desde wordpress.org y reemplace sus archivos principales:

  1. Descarga y descomprime WordPress.
  2. Cargue las carpetas wp-admin y wp-includes a su sitio a través de FTP, reemplazando las carpetas existentes.

Esto no afectará sus temas, complementos o cargas, pero reemplazará cualquier archivo principal dañado.

7. Corregir errores de sintaxis

Si recientemente agregó código personalizado a su tema o complementos, los errores de sintaxis podrían causar la pantalla en blanco. Acceda a sus archivos a través de FTP y revise los cambios recientes en busca de errores. Utilice un validador de PHP para comprobar si su código tiene problemas de sintaxis.


Prevenir la pantalla blanca en WordPress

Prevenir la pantalla blanca en WordPress implica medidas proactivas para garantizar que su sitio funcione sin problemas:

  1. Actualizaciones periódicas : mantenga WordPress, los temas y los complementos actualizados a las últimas versiones.
  2. Complementos y temas de calidad : utilice complementos y temas de buena reputación y bien codificados.
  3. Copias de seguridad de rutina : realice copias de seguridad de su sitio con regularidad para asegurarse de poder restaurarlo rápidamente si surgen problemas.
  4. Entorno de prueba : pruebe las actualizaciones y los nuevos complementos en un entorno de prueba antes de aplicarlos a su sitio en vivo.

Solución de problemas avanzada

Si los pasos básicos de solución de problemas no resuelven la pantalla blanca, considere estas técnicas avanzadas:

1. Aumento de los límites de tiempo de PHP

Los scripts de larga duración a veces pueden provocar una pantalla en blanco. Aumente el tiempo máximo de ejecución agregando esta línea a su archivo wp-config.php :

 set_time_limit(300);

Alternativamente, puedes ajustar esta configuración en tu archivo php.ini:

 max_execution_time = 300

2. Resolver problemas de bases de datos

Una base de datos corrupta puede provocar la pantalla blanca. Acceda a su base de datos a través de phpMyAdmin y verifique si hay errores. Utilice la función "Reparar" si encuentra algún problema.

3. Permisos de archivos

Los permisos de archivos incorrectos también pueden causar la pantalla blanca. Asegúrese de que sus archivos y directorios de WordPress tengan los permisos correctos:

  • Archivos: 644
  • Directorios: 755

Errores comunes y soluciones

Aquí hay algunos errores comunes asociados con la pantalla blanca en WordPress y sus soluciones:

1. Error de memoria agotada

Si ve un error como Allowed memory size of x bytes exhausted , aumentar el límite de memoria como se describió anteriormente lo resolverá.

2. Error interno del servidor 500

Un error 500 interno del servidor suele acompañar a la pantalla blanca. Consulte el registro de errores de su servidor para obtener más detalles y siga los pasos de solución de problemas descritos anteriormente.

3. Errores de sintaxis

Los errores de sintaxis en el código personalizado se pueden identificar y resolver revisando los cambios recientes y utilizando un validador de PHP.


Conclusión

La pantalla blanca en WordPress puede ser un problema frustrante, pero con una solución sistemática de problemas, es posible resolverlo y restaurar su sitio.

Al comprender las causas comunes y aplicar las soluciones proporcionadas en esta guía, podrá reparar eficazmente la pantalla blanca y evitar que vuelva a aparecer en el futuro.

El mantenimiento regular, las actualizaciones y las copias de seguridad son cruciales para mantener saludable su sitio de WordPress y evitar la temida Pantalla Blanca de la Muerte.