Pantalla blanca o "error crítico" en WordPress: cómo arreglarlo

La pantalla blanca de WordPress aparece cuando PHP encuentra un error fatal y no puede terminar de cargar la página. En las versiones actuales, WordPress suele mostrar en su lugar el aviso «Ha habido un error crítico en esta web». En ambos casos, la causa más común es un plugin o un tema que falla, y se arregla encontrándolo y desactivándolo.

Antes de tocar nada

Si todavía puedes, haz un respaldo de los archivos y de la base de datos. Anota también qué cambió justo antes del error: ¿actualizaste un plugin, cambiaste de tema o de versión de PHP? Esa pista suele ahorrar la mitad del trabajo.

Recuerda una regla simple: un cambio a la vez. Si desactivas varios plugins, cambias de tema y subes la memoria al mismo tiempo, no sabrás qué resolvió el problema.

Cómo solucionarlo paso a paso

1. Busca el correo del modo de recuperación

   Revisa la bandeja de entrada (y el spam) del correo del administrador del sitio. El asunto menciona un problema técnico en tu sitio. Abre el enlace, inicia sesión y WordPress te mostrará qué plugin o tema falló para que lo desactives.

2. Activa el registro de errores

   Edita wp-config.php y, antes de la línea que dice que dejes de editar, agrega las constantes de depuración que verás más abajo. Así los errores se guardan en un archivo y no se muestran a los visitantes.

3. Lee el archivo debug.log

   Recarga el sitio y abre wp-content/debug.log. Busca la línea con PHP Fatal error: la ruta que aparece, por ejemplo /wp-content/plugins/nombre-del-plugin/, te dice quién causa el problema.

4. Desactiva el plugin o el tema culpable

   Renombra su carpeta (por ejemplo, de nombre-del-plugin a nombre-del-plugin.off). Si no sabes cuál es, renombra la carpeta wp-content/plugins completa para desactivarlos todos y comprobar si el sitio vuelve.

5. Reactiva de a uno y apaga la depuración

   Devuelve el nombre original a la carpeta y reactiva los plugins uno por uno desde el escritorio hasta que reaparezca el error. Cuando termines, vuelve a poner WP_DEBUG en false y borra debug.log.

Las constantes de depuración que debes usar

Agrega estas líneas en wp-config.php, antes del comentario que indica que dejes de editar. Si alguna ya existe, cambia su valor en lugar de duplicarla:

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

Con esta combinación, WordPress guarda los errores en wp-content/debug.log sin mostrarlos en pantalla a tus visitantes. Una línea típica del registro se ve así:

PHP Fatal error:  Uncaught Error: Call to undefined function ...
in /home/usuario/public_html/wp-content/plugins/nombre-del-plugin/archivo.php:142

Lo importante es la ruta: todo lo que está después de /plugins/ o /themes/ es el nombre de la carpeta del plugin o del tema que falla.

Si el problema es el tema

Si el registro apunta a /wp-content/themes/, renombra la carpeta del tema activo. WordPress intentará usar otro tema instalado, por eso conviene tener siempre un tema por defecto de WordPress instalado aunque no lo uses. Si no hay ningún otro tema, sube uno por defecto desde wordpress.org a la carpeta wp-content/themes.

Otras causas menos comunes

Si el registro muestra un error de memoria, sigue la guía sobre el error de límite de memoria de PHP. Si en vez de una página en blanco ves un error 500, revisa la guía del error 500 en WordPress.

Cómo evitar que vuelva a pasar

• Actualiza los plugins de a uno y revisa el sitio después de cada actualización importante.
• Instala solo plugins mantenidos y compatibles con tu versión de WordPress y de PHP.
• Ten respaldos automáticos que puedas restaurar rápidamente.
• Antes de cambiar la versión de PHP, revisa en Herramientas › Salud del sitio si hay avisos de compatibilidad.

Guía revisada con WordPress 7.1.