Cómo arreglar la pantalla blanca de la muerte de WordPress

La pantalla blanca de la muerte de WordPress es uno de los problemas más inquietantes con los que puede encontrarse, justamente porque no le dice nada. Carga su sitio — o el Escritorio de WordPress — y recibe una página blanca, en blanco. Ningún error, ningún mensaje, ninguna pista. El apodo es dramático, pero la realidad suele ser corriente: algo del código de su sitio tuvo un error fatal y WordPress simplemente dejó de mostrar la página. En la mayoría de los casos es un arreglo rápido cuando sabe dónde mirar.

La pantalla en blanco casi siempre viene de una de tres cosas: un plugin, su tema o el servidor quedándose sin memoria. Primero activaremos el registro de errores de WordPress para que no trabaje a ciegas, y después revisaremos cada causa por turno.

Paso 1: active el modo de depuración para ver el error real

Antes de adivinar, haga que WordPress le muestre qué salió mal de verdad. Abra su archivo wp-config.php (el archivo principal de configuración de WordPress) por SFTP (una forma segura de conectarse a los archivos de su sitio) o con el administrador de archivos de su proveedor y busque la línea que dice define('WP_DEBUG', false);. Reemplácela por estas tres líneas:

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

Ahora vuelva a cargar la página. En lugar de nada, WordPress escribe el error en un archivo en wp-content/debug.log. Ábralo y lea las últimas líneas — normalmente verá algo como “Fatal error… in /wp-content/plugins/some-plugin/file.php”. Esa sola línea muchas veces nombra al culpable y le ahorra el resto de esta guía. Cuando termine de investigar, vuelva a poner WP_DEBUG en false para que los errores no se registren para siempre.

Paso 2: sospeche de lo último que cambió

Las pantallas blancas casi nunca aparecen de la nada. Haga memoria: ¿acaba de actualizar o instalar un plugin, cambiar o editar un tema, o se hizo una actualización automática durante la noche? Lo último que cambió es su primer sospechoso, y deshacerlo muchas veces es todo el arreglo.

Paso 3: desactive todos los plugins

Los plugins son la causa más común. Si todavía puede acceder al Escritorio de WordPress, desactívelos todos a la vez y después vuelva a activarlos de uno en uno, recargando el sitio después de cada uno. El que hace volver la pantalla blanca es su plugin problemático.

Si la pantalla blanca también le dejó fuera del Escritorio de WordPress, haga lo mismo por SFTP: cambie el nombre de la carpeta wp-content/plugins a algo como plugins-off. Eso desactiva todos los plugins al instante. Si su sitio vuelve, devuélvale a la carpeta el nombre plugins — sus plugins seguirán ahí, solo desactivados — y vuelva a activarlos uno por uno para encontrar el malo.

Paso 4: cámbiese a un tema predeterminado

Si los plugins no son la causa, el siguiente candidato es un tema roto — sobre todo si usted (o un desarrollador) editó hace poco functions.php. Un solo carácter suelto en ese archivo deja en blanco todo el sitio. Cámbiese temporalmente a un tema de serie como Twenty Twenty-Four. Si no puede entrar, cambie el nombre de la carpeta de su tema activo en wp-content/themes por SFTP; WordPress vuelve automáticamente a un tema predeterminado. Si el sitio carga, el tema es la respuesta.

Paso 5: suba el límite de memoria de PHP

A veces no hay ningún plugin ni tema malo — el sitio simplemente se quedó sin memoria a mitad de la página y se rindió, dejando una pantalla en blanco. Dele más margen agregando esta línea a wp-config.php:

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

Si eso lo arregla, tome nota de la lección: un sitio que choca constantemente con un techo de memoria bajo es un sitio apretado por un plan con poca potencia. En el hosting de ganga, la memoria muchas veces se limita a poco para meter más clientes en un mismo servidor.

Paso 6: compruebe si hay un archivo de WordPress dañado

Rara vez, uno de los propios archivos de WordPress se daña durante una actualización fallida. El arreglo seguro es volver a subir copias nuevas de las carpetas wp-admin y wp-includes desde una descarga limpia de WordPress (nunca toque wp-content ni wp-config.php — ahí están su contenido y sus ajustes). Si no se siente cómodo haciéndolo, es un buen momento para pedir ayuda en lugar de arriesgarse a un paso en falso.

Cuando el arreglo es el proveedor, no el archivo

Dos de las causas más comunes de la pantalla blanca — quedarse sin memoria y las actualizaciones automáticas fallidas — son en realidad problemas del hosting disfrazados de algo técnico. Un buen proveedor le da a su sitio memoria suficiente para respirar, y aplica las actualizaciones con cuidado en lugar de dejar que una a medio terminar dañe un archivo.

Esa es la diferencia de todos los días con el hosting de WordPress administrado. Nuestros planes incluyen recursos de sobra para que los techos de memoria no sean una pelea diaria, y las actualizaciones son automáticas y verificadas — cada vez que actualizamos su sitio, comprobamos que se siga viendo y funcionando bien, así que una mala actualización de un plugin se detecta y se deshace antes de que llegue a dejar en blanco su sitio en vivo. Es la diferencia entre “una actualización me rompió el sitio” y no enterarse nunca porque ya estaba resuelto.

Si todo lo demás falla: vuelva a una versión que funcione

Si no encuentra la causa, o un arreglo empeoró las cosas, deje de editar y restaure. Una copia de seguridad limpia y reciente devuelve todo su sitio al último momento en que funcionaba — sin necesidad de trabajo de detective. Nuestra guía sobre cómo restaurar WordPress desde una copia de seguridad lo explica, y cada plan que llevamos guarda copias de seguridad externas 3 veces al día, así que una copia limpia siempre está a un pedido de distancia.

La versión corta

  1. Active el registro de depuración y lea debug.log.
  2. Deshaga lo último que cambió.
  3. Desactive los plugins (cambie el nombre de la carpeta si no puede entrar).
  4. Cámbiese a un tema predeterminado.
  5. Suba el límite de memoria de PHP (el lenguaje de programación con el que funciona WordPress).
  6. Vuelva a subir los archivos de WordPress, o restaure desde una copia de seguridad.

Si la pantalla blanca no se mueve — o prefiere no editar archivos de configuración en vivo mientras su negocio está fuera de línea — déjelo en otras manos. Arreglar pantallas en blanco es trabajo de rutina para nuestro equipo con base en EE. UU. y, si sigue pasando, mudarse a un hosting con recursos de verdad normalmente le pone fin. Para los síntomas vecinos, vea nuestra lista de revisión de emergencia y nuestro arreglo para el error de conexión con la base de datos.