Arreglar pantalla blanca por plugin en WordPress

¿Qué es la pantalla blanca en WordPress y por qué ocurre?

La llamada pantalla blanca de la muerte en WordPress (White Screen of Death, WSOD) es uno de los errores más frecuentes y frustrantes. Consiste en que, al acceder al sitio web o al panel de administración, solo se muestra una página completamente en blanco, sin mensajes de error visibles. Aunque puede tener varias causas, una de las más habituales es un plugin defectuoso, mal configurado o incompatible con la versión de WordPress, el tema activo u otros plugins.

Este problema suele estar relacionado con errores de PHP, conflictos de código o límites de recursos del servidor. Cuando el error no se muestra en pantalla, WordPress simplemente deja de procesar la página y el navegador muestra un lienzo vacío. Por eso, el primer paso para arreglar la pantalla blanca es entender que, en la mayoría de los casos, no se trata de que el sitio haya desaparecido, sino de que hay un fallo en la ejecución del código.

Síntomas y errores comunes relacionados con plugins

Aunque la pantalla blanca es el síntoma principal, hay otros indicios que apuntan a un plugin como responsable del error. Identificarlos te ayudará a diagnosticar el problema con mayor rapidez y precisión.

• Pantalla completamente en blanco al entrar en la portada de la web.
• Pantalla blanca solo en el área de administración (/wp-admin).
• Error crítico de WordPress con mensaje genérico y botón de Modo de recuperación.
• Mensaje de error de PHP indicando un archivo dentro de la carpeta /wp-content/plugins/.
• Pantalla blanca después de activar o actualizar un plugin concreto.
• Fallo solo en determinadas páginas (por ejemplo, la tienda, el carrito o el checkout en WooCommerce).

En muchos casos, WordPress envía un correo electrónico al administrador con información adicional sobre el error, indicando qué plugin ha provocado el fallo. Revisa siempre la bandeja de entrada (y la carpeta de spam) de la cuenta de correo asociada a la instalación.

Cómo comprobar si un plugin es el problema

Antes de aplicar soluciones más avanzadas, conviene confirmar que la pantalla blanca está realmente causada por un plugin. Para ello, el procedimiento estándar consiste en desactivar todos los plugins y comprobar si el sitio vuelve a funcionar. Si la web se carga correctamente sin plugins, sabrás que el origen del error está en uno de ellos.

El proceso general es el siguiente:

• Desactivar todos los plugins de WordPress (desde el panel, por FTP o desde el gestor de archivos del hosting).
• Comprobar si la web y el panel de administración cargan con normalidad.
• Reactivar los plugins uno a uno (o en pequeños grupos) hasta que la pantalla blanca reaparezca.
• Identificar el plugin concreto que provoca el fallo y dejarlo desactivado.

Si al desactivar todos los plugins la pantalla blanca persiste, es posible que el problema esté en el tema activo, en el archivo functions.php, en un fragmento de código personalizado o en la configuración del servidor. Aun así, conviene completar este paso para descartar la causa más frecuente.

Solución rápida desde el panel de WordPress

Si todavía puedes acceder al panel de administración de WordPress, la forma más sencilla de arreglar la pantalla blanca provocada por un plugin es gestionarlo directamente desde la sección de plugins. Este método es ideal cuando la pantalla blanca solo aparece en la parte pública de la web o en páginas concretas.

• Accede a Plugins > Plugins instalados.
• Ordena los plugins por Activo para ver rápidamente cuáles están en uso.
• Si recuerdas qué plugin activaste o actualizaste antes del error, desactívalo primero.
• Si no lo recuerdas, desactiva todos los plugins marcándolos y usando la acción masiva Desactivar.
• Visita la portada de la web en una pestaña nueva y comprueba si la pantalla blanca ha desaparecido.

Cuando la web vuelva a mostrarse con normalidad, reactiva los plugins uno por uno. Tras cada activación, recarga la web. En el momento en que la pantalla blanca reaparezca, habrás localizado el plugin problemático.

Desactivar plugins por FTP o gestor de archivos

Si la pantalla blanca afecta también al panel de administración y no puedes entrar en /wp-admin, tendrás que desactivar los plugins desde el servidor. Para ello puedes usar un cliente FTP (como FileZilla) o el gestor de archivos del panel de control de tu hosting (cPanel, Plesk, etc.).

Sigue estos pasos:

• Conéctate al servidor y localiza la carpeta donde está instalado WordPress (normalmente public_html o www).
• Entra en wp-content y luego en plugins.
• Para desactivar todos los plugins de golpe, renombra la carpeta plugins a algo como plugins-desactivados.
• Visita tu web en el navegador. Si la pantalla blanca desaparece, confirma que el problema estaba en algún plugin.
• Vuelve a renombrar la carpeta a plugins y, dentro de ella, ve renombrando las carpetas de los plugins uno por uno para localizar el que causa el error.

Cada vez que renombres la carpeta de un plugin concreto, WordPress lo considerará desactivado. Recarga la web tras cada cambio para comprobar si el error se ha resuelto. Cuando encuentres el plugin responsable, puedes eliminarlo, buscar una versión anterior o contactar con su desarrollador.

Usar el modo depuración de WordPress para encontrar el plugin

Cuando la pantalla blanca no muestra ningún mensaje de error, activar el modo de depuración de WordPress es una de las formas más eficaces de identificar el plugin que está fallando. Este modo hace que los errores de PHP se registren en un archivo de log o se muestren en pantalla, indicando el archivo y la línea donde se produce el problema.

Para activar la depuración, edita el archivo wp-config.php en la raíz de tu instalación de WordPress y añade (o modifica) las siguientes líneas justo antes de /* That's all, stop editing! Happy publishing. */:

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

Después de activar la depuración, recarga la página que muestra la pantalla blanca y luego revisa el archivo debug.log. Busca líneas que hagan referencia a la carpeta /wp-content/plugins/. Normalmente verás algo como:

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

El nombre de la carpeta del plugin y el archivo implicado te indicarán qué extensión está causando el error. Una vez identificado, puedes desactivarlo por FTP o desde el panel de administración si aún tienes acceso.

Conflictos entre plugins y temas: cómo detectarlos

No siempre es un único plugin defectuoso el que provoca la pantalla blanca. En muchos casos, el problema surge por un conflicto entre dos plugins o entre un plugin y el tema activo. Estos conflictos pueden deberse a funciones duplicadas, versiones incompatibles de librerías o modificaciones agresivas del núcleo de WordPress.

Para detectar conflictos, puedes seguir esta metodología:

• Activa un tema por defecto de WordPress (por ejemplo, Twenty Twenty-Four) y comprueba si el error desaparece.
• Si con el tema por defecto la web funciona, el conflicto puede estar entre tu tema actual y uno de los plugins.
• Con el tema por defecto activo, ve activando los plugins uno a uno hasta reproducir el error.
• Si el error solo aparece con una combinación concreta de tema + plugin, habrás identificado el conflicto.

En ocasiones, el conflicto se debe a un plugin desactualizado que no soporta la última versión de WordPress o del tema. Revisa siempre la ficha del plugin en el repositorio oficial o en la web del desarrollador para comprobar su compatibilidad.

Ajustes de PHP y límites de memoria relacionados con plugins

Algunos plugins, especialmente los de maquetación visual, comercio electrónico, copias de seguridad o seguridad, consumen muchos recursos del servidor. Si el límite de memoria de PHP es demasiado bajo, la ejecución puede interrumpirse y dar lugar a una pantalla blanca. En estos casos, el plugin no está necesariamente mal programado, sino que el servidor no dispone de recursos suficientes para ejecutarlo.

Para aumentar la memoria disponible para WordPress, puedes probar estas opciones:

• Editar wp-config.php y añadir:
  define( 'WP_MEMORY_LIMIT', '256M' );
• Modificar el archivo php.ini (si tienes acceso) y aumentar memory_limit a 256M o más.
• Crear o editar el archivo .htaccess y añadir:
  php_value memory_limit 256M (si el hosting lo permite).
• Solicitar al soporte de tu proveedor de hosting que aumente el límite de memoria de PHP.

Además de la memoria, otros parámetros como max_execution_time o max_input_vars pueden influir en el correcto funcionamiento de algunos plugins. Si la pantalla blanca aparece al ejecutar tareas pesadas (importaciones, copias de seguridad, regeneración de miniaturas, etc.), revisa también estos valores.

Buenas prácticas para evitar la pantalla blanca por plugins

Prevenir la pantalla blanca es más eficiente que tener que arreglarla cada vez que aparece. Adoptar una serie de buenas prácticas en la gestión de plugins reducirá drásticamente la probabilidad de que tu sitio WordPress deje de funcionar por culpa de una extensión problemática.

• Instala solo plugins de confianza, con buenas valoraciones, soporte activo y actualizaciones frecuentes.
• Evita los plugins nulled o descargados de fuentes no oficiales, ya que suelen contener código malicioso o defectuoso.
• Limita el número de plugins a los realmente necesarios. Menos plugins significa menos posibilidades de conflicto.
• Prueba los plugins en un entorno de staging antes de instalarlos o actualizarlos en la web en producción.
• Realiza copias de seguridad completas antes de grandes cambios (actualizaciones masivas, instalación de nuevos plugins, cambios de tema, etc.).
• Mantén WordPress, el tema y los plugins actualizados, pero de forma controlada y planificada.
• Revisa periódicamente el registro de errores del servidor y el archivo debug.log si lo utilizas.

Aplicar estas prácticas no solo te ayudará a evitar pantallas blancas, sino que también mejorará el rendimiento, la seguridad y la estabilidad general de tu sitio web.

Cuándo contactar con el soporte del hosting o del plugin

Aunque muchas pantallas blancas se pueden resolver siguiendo los pasos anteriores, hay situaciones en las que es recomendable pedir ayuda al soporte técnico de tu proveedor de hosting o al desarrollador del plugin implicado. Esto es especialmente importante si tu sitio genera ingresos o maneja datos sensibles.

Contacta con el soporte del hosting cuando:

• No puedes acceder al servidor por FTP o el gestor de archivos no funciona correctamente.
• Los errores apuntan a límites de recursos (memoria, CPU, procesos simultáneos) que no puedes modificar.
• La pantalla blanca aparece de forma intermitente y afecta a varios sitios en el mismo servidor.
• Necesitas restaurar una copia de seguridad completa del servidor.

Contacta con el soporte del plugin cuando:

• Has identificado claramente que un plugin concreto provoca la pantalla blanca.
• El error aparece después de una actualización reciente del plugin.
• El archivo debug.log muestra errores específicos dentro de la carpeta del plugin.
• Has probado en un entorno de staging y el problema se reproduce de forma consistente.

Al abrir un ticket de soporte, proporciona siempre la máxima información posible: versión de WordPress, tema activo, lista de plugins, pasos para reproducir el error, mensajes del archivo debug.log y capturas de pantalla si es necesario. Cuantos más datos aportes, más rápido podrán ayudarte.

Preguntas frecuentes