Reparar la pantalla blanca de la muerte o White Screen of Death (WSoD)

Generalidades

En este artículo se enumeran los pasos habituales para solucionar problemas relacionados con la pantalla blanca de la muerte (WSOD) en tu sitio WordPress.

Antecedentes

La pantalla blanca de la muerte de WordPress (WSOD) hace que tu sitio muestre una página en blanco sin más información. La mayoría de las veces, esto se debe a un error de PHP, aunque solucionarlo puede ser difícil ya que se muestra información limitada cuando sucede.

Cómo solucionar el WSOD

WordPress 5.2 eresenta un nuevo servicio para ayudar a solucionar problemas del WSOD.

Diagnosticar la WSOD

Si tu sitio falla debido a un problema con un tema o un plugin, normalmente aparecerá uno de los siguientes mensajes:

El sitio está experimentando dificultades técnicas.

El sitio está experimentando dificultades técnicas. Por favor, revise la bandeja de entrada de correo electrónico del administrador del sitio para obtener instrucciones.

Ha ocurrido un error crítico en su sitio web.

Se ha producido un error crítico en su sitio web. Consulte la bandeja de entrada de correo electrónico del administrador de su sitio para obtener instrucciones.

Si esto sucede, se envía un correo al administrador del sitio con una URL única que te permite ingresar a tu sitio a través del modo de recuperación. Revisa esta sección si no recibes el correo electrónico.

Corregir el error

Para solucionar el error WSOD en WordPress:

Inicia sesión en tu sitio WordPress.

Aparecerá un mensaje de error similar al siguiente en la parte superior del panel. Este ejemplo indica que hay un problema con el tema:

Uno o más temas no se cargaron correctamente. Puedes encontrar más detalles y realizar cambios en la página Temas.
Da clic en el enlace del mensaje, que abre la página Apariencia > Temas.

Aparece un mensaje de error similar al siguiente:

ERROR: This theme failed to load properly and was paused within the admin backend.
Desplázate hasta la parte inferior de la página, donde una alerta te informa que el tema no se está cargando.
Haz clic en el botón Reanudar junto al tema.

Esto debería solucionar el error, pero es posible que el tema o el plugin sigan fallando:

The theme could not be resumed because it triggered a fatal error.

Si esto sucede, sigue los pasos de la sección de pasos solución de problemas o vuelva a instalar una copia nueva del tema o plugin.

Si no recibes el correo

Si no recibiste el correo de recuperación, debes verificar los siguientes problemas comunes.

Limpiar tu caché

Limpia cualquier plugin de almacenamiento en caché que puedas estar ejecutando, así como el servidor, el navegador y el caché de Cloudflare si es necesario:

Solucionar problemas del buscador

Tu navegador puede ayudarte a identificar problemas o conflictos de JavaScript mediante sus herramientas integradas. Revisa este artículo a continuación para obtener más información.

Asegurarse de que el editor visual esté habilitado

Visita tu Usuarios >Tu perfil en la página de Administración de WordPress. La primera opción deshabilitará el editor visual. Asegúrate de que la opción esté desmarcada.

Reinstalar los archivos principales de WordPress

Intenta reinstalar los archivos principales de WordPress. Tu directorio /wp-content permanecerá intacto.

Otros pasos de solución de problemas

Hay algunos otros pasos comunes de solución de problemas de WordPress que pueden solucionar el error WSOD, que se describen a continuación.

Deshabilitar tu plugins

Los errores con un plugin o tema suelen ser la causa del error WSOD. Primero deberías intentar deshabilitar tus plugins para ver si eso soluciona el error.

Activar un tema diferente

También puedes intentar activar un tema diferente usando wp-cli:

Revisa qué temas están disponibles para activar:
```
[server]$ wp theme list
```
Activa un tema diferente. Por ejemplo, aquí aparece cómo activar el tema predeterminado llamado twentynineteen:
```
[server]$ wp theme activate twentynineteen
```
Revisa tu sitio para ver si eso soluciona el error.

Habilitar la depuración de WordPress

WordPress tiene una función integrada que te permite ver y registrar errores. Después de activarla, puedes elegir ver los errores en tu sitio en vivo o registrarlos en un archivo en tu servidor.

Aumentar el límite de memoria de PHP

PHP necesita una cierta cantidad de memoria para funcionar correctamente. La cantidad que necesites depende de tu sitio web, pero siempre puedes incrementar este límite en tu configuración de PHP.

Limpiar tu caché cache

También puedes usar wp-cli para limpiar el caché de tu sitio en el servidor.

Ver también