Pantalla blanca de la muerte de WordPress

Qué significa este error y cómo reconocerlo

• El sitio público de WordPress, el panel de administración o ambos muestran una página blanca completamente vacía y sin mensajes de error.
• El fallo puede afectar a todo el sitio o únicamente a una pantalla específica del panel, plantilla, shortcode, bloque o URL.
• La página en blanco puede aparecer inmediatamente después de instalar o actualizar un plugin o tema.
• El problema puede comenzar después de que el proveedor de hosting cambie la versión de PHP del sitio.
• Las solicitudes afectadas siguen mostrando una página en blanco hasta corregir el plugin, tema, problema de memoria, incompatibilidad o archivo dañado que provoca el fallo de PHP.

Causas principales, ordenadas por probabilidad

1. Un error fatal de PHP en un plugin — es la causa más probable cuando el problema comienza después de instalar o actualizar un plugin, o cuando solo fallan las páginas relacionadas con plugins.
2. Un error en el tema activo — un problema en el tema o en su archivo functions.php puede afectar a muchas páginas o a todo el sitio.
3. Memoria de PHP agotada — una solicitud puede superar el memory_limit configurado; el registro suele mostrar Allowed memory size exhausted.
4. Incompatibilidad con la versión de PHP — un plugin o tema puede contener código que no funciona con la versión de PHP que utiliza actualmente el proveedor de hosting.
5. Archivos del núcleo de WordPress dañados — una actualización interrumpida o incompleta puede dañar archivos del núcleo, aunque es menos probable cuando el fallo sigue claramente a un cambio en un plugin o tema.

Cómo solucionarlo

1. Protege el sitio e identifica la solicitud que falla

Si las herramientas de tu hosting proporcionan copias de seguridad, crea una antes de editar archivos. Anota si la página en blanco afecta al sitio público, al panel o solo a una URL concreta. Necesitarás acceso mediante SFTP o al panel de archivos del hosting, además de permisos para editar wp-config.php.

2. Activa el registro de depuración sin mostrar errores a los visitantes

Abre wp-config.php y añade o actualiza estos ajustes para que cada constante aparezca una sola vez:

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

Mantén WP_DEBUG_DISPLAY establecido en false en un sitio en producción. Vuelve a cargar la URL exacta que muestra la pantalla blanca y revisa wp-content/debug.log. Busca el error fatal, la ruta del archivo y el número de línea. Si no se crea el registro de WordPress o no contiene el evento, pide al proveedor de hosting que revise el registro de errores de PHP de la cuenta.

3. Desactiva el plugin identificado en el registro

Si el error indica un plugin, utiliza SFTP o el administrador de archivos del hosting para abrir wp-content/plugins/. Cambia el nombre de la carpeta del plugin correspondiente añadiendo un sufijo como -disabled. Cambiar el nombre impide que WordPress cargue el plugin, pero conserva sus archivos y ajustes.

Vuelve a cargar la URL que falla. Si funciona, el plugin es la causa inmediata. Busca una actualización compatible o contacta con el desarrollador del plugin si no existe una actualización adecuada para las versiones de WordPress y PHP del sitio. No dejes activo un plugin incompatible u obsoleto solo porque cambiar el nombre de su carpeta haya restaurado el sitio.

4. Prueba el tema activo

Si el registro apunta al tema activo o desactivar el plugin identificado no ayuda, cambia el nombre de la carpeta de ese tema en wp-content/themes/. WordPress debería recurrir a un tema predeterminado disponible.

Si el sitio se recupera, revisa el archivo y la línea indicados en el registro, prestando especial atención a functions.php. Si no hay instalado ningún tema de respaldo utilizable, restaura el nombre original de la carpeta después de la prueba y contacta con el proveedor del tema o el hosting antes de realizar más cambios.

5. Resuelve un error por agotamiento de memoria

Si el registro muestra Allowed memory size exhausted, la solicitud fallida superó el límite de memoria de PHP configurado. Sigue el procedimiento de administración de WordPress o del hosting del sitio para aumentar el límite de forma segura e investiga si un plugin, tema o solicitud concreta está consumiendo demasiada memoria.

Después de realizar un cambio de configuración autorizado, vuelve a cargar la misma URL y confirma que ya no se registra el mismo error fatal. Aumentar el límite puede simplemente ocultar un componente ineficiente o incompatible, así que continúa investigando si el error vuelve a aparecer.

6. Comprueba la compatibilidad con la versión de PHP

Si la pantalla blanca comenzó después de un cambio de versión de PHP, compara el momento del cambio con el plugin o tema mencionado en el registro. Desactivar temporalmente esa extensión puede ayudar a confirmar la relación.

Pregunta al proveedor de hosting si es posible volver temporalmente a una versión anterior de PHP mientras se actualiza, sustituye o corrige el plugin o tema. Considera la reversión como una medida de diagnóstico o temporal, no como una solución de compatibilidad permanente.

7. Restaura los archivos del núcleo solo cuando las pruebas lo respalden

Si ningún cambio en plugins, temas, PHP o memoria explica el fallo y el registro no identifica ninguna extensión, es posible que haya archivos del núcleo de WordPress dañados. Vuelve a subir archivos coincidentes del núcleo de WordPress desde una descarga oficial nueva mediante SFTP.

No sobrescribas wp-content ni wp-config.php. Si no puedes distinguir con seguridad los archivos del núcleo del contenido y la configuración del sitio, detente y pide ayuda al proveedor de hosting o a un profesional de WordPress.

8. Verifica la recuperación y limpia los cambios

Vuelve a cargar la URL exacta del sitio público o la pantalla de administración que estaba en blanco. Prueba las páginas relacionadas que utilicen el mismo plugin, tema, shortcode o bloque. Revisa wp-content/debug.log y confirma que el mismo error fatal no se repita.

Una vez confirmada la causa, desactiva los cambios temporales de depuración o asegúrate de que cualquier registro que conserves esté protegido frente al acceso público.

Prevención y cómo verificar la solución

• Haz una copia de seguridad del sitio antes de actualizar WordPress, plugins, temas o la versión de PHP del hosting.
• Actualiza los plugins y temas de uno en uno para poder identificar el cambio asociado a un fallo.
• Prueba los cambios importantes de WordPress, PHP, temas y plugins en una copia de staging antes de aplicarlos en producción.
• Mantén WP_DEBUG_DISPLAY desactivado en los sitios en producción y restringe el acceso a cualquier registro de depuración.
• Supervisa la memoria de PHP disponible e investiga los componentes que se acerquen repetidamente al límite configurado.
• Después de cada corrección, vuelve a cargar la URL exacta que fallaba y revisa el registro para comprobar que no reaparezca el mismo error fatal.

Preguntas frecuentes