Arreglar error WSOD WordPress

¿Qué es el error WSOD WordPress y por qué ocurre?

Llamamos error WSOD WordPress (White Screen of Death) a ese momento en que el corazón se te para: entras a tu web y no ves nada. Es una página en blanco, total, absoluta. No hay códigos, no hay avisos de error 500, ni barra lateral. El navegador simplemente se rinde. Es silencioso, lo que lo hace, si cabe, más irritante que otros fallos que al menos te gritan qué va mal.

Técnicamente hablando, esto suele ser un agotamiento de la memoria límite de PHP o un fallo de sintaxis que detiene todo el proceso. El servidor, al encontrar un obstáculo insalvable, frena la carga para no exponer información sensible o dañar algo más. El resultado es ese vacío. Las causas casi siempre son las mismas: un plugin que se ha actualizado y no se lleva bien con tu versión, un tema conflictivo o, simplemente, dos funciones peleándose por los mismos recursos.

Paso 1: Habilitar el modo de depuración de WordPress

Deja de adivinar. Necesitas certeza, y para eso hay que activar el modo de depuración. WordPress, por seguridad, le esconde los errores a los visitantes, pero tú como administrador tienes derecho a saber qué se rompió. Tienes que entrar al servidor, ya sea por FTP o usando el gestor de archivos de tu panel (cPanel, Plesk, da igual).

Busca el archivo wp-config.php en la raíz de la instalación. Ábrelo y localiza esta línea:

define( 'WP_DEBUG', false );

Cambia ese false por true. Y haz algo más: añade un par de líneas para que los errores se guarden en un log y no se mezclen en la pantalla (donde de todos modos no los verás por la pantalla blanca). Pon esto justo debajo:

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

Guarda y recarga. Seguirás viendo blanco, pero si vas a la carpeta /wp-content/, encontrarás un archivo nuevo: debug.log. Ábrelo. Ahí está la verdad, el error fatal exacto, ya sea un «Allowed memory size of…» o un «Call to undefined function…». Sin eso, estás navegando a ciegas.

Paso 2: Aumentar el límite de memoria PHP

A veces el log te dice la verdad clara: no hay memoria. Si ves algo como Allowed memory size exhausted, tu sitio se ha quedado sin espacio mental. WordPress intenta usar 40MB por defecto, lo cual hoy en día es poco si tienes varios plugins activos o un tema pesado.

Tienes dos salidas. La primera es rápida. Edita otra vez el wp-config.php y, justo antes de la línea que dice «That’s all, stop editing!», inserta esto:

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

Si no funciona, es que tu servidor bloquea ese cambio desde WordPress. Entonces toca crear o modificar un archivo php.ini en la carpeta raíz y añadir esta directiva:

memory_limit = 256M

Paso 3: Desactivar todos los plugins y temas

Si la memoria no es el problema, casi seguro es un conflicto de código. Tienes que encontrar al culpable y como no puedes entrar al administrador, tocarás hacerlo a mano, vía FTP o gestor de archivos.

Desactivación de plugins

Ve a /wp-content/ y busca la carpeta /plugins/. No la borres, por favor. Simplemente cámbiale el nombre. Ponle «plugins_desactivados», por ejemplo. WordPress al no encontrar la ruta original, desactivará todos los plugins de golpe y dejará el sitio en un estado básico.

Recarga la web. ¿Vuelve a cargar? Entonces el problema era un plugin. Para saber cuál, devuelve el nombre a «plugins» y entra en esa carpeta. Ahora renombra cada carpeta de plugin uno por uno (ponle «_old» al final), recargando la web cada vez. Cuando vuelva la pantalla blanca, ya lo tienes: el último que renombraste es el que está rompiendo todo.

Cambiar al tema por defecto

Si los plugins no son los culpables, mira el tema. Entra en /wp-content/themes/. Verás la carpeta de tu tema activo. Cámbiale el nombre (añade «_old» al final). WordPress se dará cuenta de que falta y, por seguridad, activará el tema por defecto que trae el sistema (suele ser un Twenty Twenty-Four o similar).

Si con esto la web resucita, el problema está en el archivo functions.php de tu tema. Revisa lo último que tocaste ahí o restaura una copia de seguridad de ese archivo.

Paso 4: Revisar el archivo functions.php

He perdido la cuenta de cuántas veces el WSOD ha sido culpa de un pequeño error en el functions.php, ya sea del tema principal o del hijo. Suele pasar al editar el archivo para pegar algún snippet de internet y olvidarse de cerrar un paréntesis, un punto y coma o una llave. Un solo carácter fuera de sitio corrompe todo el PHP.

Si puedes, abre el functions.php de tu tema activo. Mira el final del archivo. A veces, al copiar código, se cuelan espacios en blanco después de la etiqueta de cierre ?>, y eso provoca errores de cabecera («headers already sent») que terminan en pantalla blanca. Si tocaste algo recientemente, deshazlo. Si no, reemplaza el archivo por uno limpio de una copia de seguridad.

Conclusión

Se te pone el cuerpo a piel cuando ves el error WSOD WordPress, lo sé. Pero es un problema técnico, y los técnicos tienen lógica. Si sigues el orden —mirar los logs, checar la memoria y aislar plugins o temas— vas a dar con la causa raíz en minutos. La mayoría de las veces es algo que pasó tras una actualización o una edición descuidada. Tener copias de seguridad actualizadas antes de tocar nada es tu mejor red de seguridad. Y si después de todo esto sigues bloqueado o no te sientes cómodo tocando el núcleo del sistema, en RedServicio (redservicio.net) estamos aquí para echarte una mano y recuperar tu web profesionalmente.