Cuando la web se queda en blanco
Pocas cosas inquietan tanto como abrir la propia web y no encontrar nada: una página en blanco, un escueto aviso de "error crítico" o un seco "500 Internal Server Error". Sin menú, sin contenido y, a veces, sin acceso al escritorio.
La buena noticia es que estos fallos parecen graves, pero casi siempre tienen causas corrientes: un plugin que choca con una actualización, un tema que necesita una versión de PHP más reciente, un sitio que se ha quedado sin memoria o un archivo de configuración con una errata. Casi todos se resuelven sin ayuda de un desarrollador y sin perder contenido. Las entradas, las páginas y los pedidos siguen a salvo en la base de datos; lo que ha fallado es el código que los muestra.
Esta guía explica cómo interpretar los síntomas, localizar el mensaje de error real, corregir las causas más frecuentes y decidir cuándo conviene restaurar una copia de seguridad o recurrir al hosting. Forma parte de nuestra serie sobre mantenimiento de WordPress y completa los pasos de recuperación del artículo sobre actualizaciones seguras.
Primero, leer los síntomas
Lo que aparece en pantalla ya acota bastante el problema.
| Lo que se ve | Lo que suele significar |
|---|---|
| "Ha habido un error crítico en esta web" | Un error fatal de PHP que WordPress ha capturado. Lo más probable es que la causa sea un plugin o el tema, y WordPress habrá enviado un correo al administrador. |
| Una página completamente en blanco | Un error fatal de PHP con la visualización de errores desactivada, frecuente en instalaciones antiguas. Las mismas causas, pero sin correo ni mensaje que ayude. |
| "500 Internal Server Error" | El propio servidor web no ha podido procesar la petición. Causas habituales: un .htaccess dañado, permisos de archivo incorrectos, un fallo de PHP o un límite del servidor. |
| "502 Bad Gateway" o "504 Gateway Timeout" | El servidor ha tardado demasiado o un componente intermedio ha dejado de responder. Suele ser un problema del hosting o de un proceso lento y pesado. |
| "503 Service Unavailable" | El servidor está saturado o en mantenimiento temporal. Normalmente es cosa del hosting o de un pico de tráfico. |
| "Temporalmente no disponible por mantenimiento programado" | Una actualización se ha interrumpido y WordPress sigue en modo mantenimiento. |
| "Error al establecer una conexión con la base de datos" | WordPress no logra conectar con su base de datos: credenciales incorrectas en wp-config.php o un servidor de base de datos caído. |
Esta guía se centra en los tres primeros casos, que son los que normalmente se pueden resolver sin ayuda. Los demás reciben una respuesta breve en las secciones siguientes.
Los primeros cinco minutos
Antes de tocar ningún archivo, merece la pena dedicar unos minutos a reunir datos. Muchas veces señalan directamente la causa.
- ¿Falla todo el sitio o solo una parte? Conviene revisar la portada, una página interior y
/wp-adminen una ventana privada del navegador. Un escritorio en blanco con la parte pública funcionando (o al revés) es una pista importante. - ¿Qué ha cambiado últimamente? Una actualización, un plugin nuevo, una edición del tema, un cambio de versión de PHP por parte del hosting, una migración. La mayoría de las pantallas en blanco aparecen minutos después de un cambio. El registro de mantenimiento o los correos de actualización de WordPress lo aclaran.
- Revisar el correo del administrador. Si WordPress ha capturado el error, habrá enviado un correo con el nombre del plugin o tema responsable y un enlace al modo de recuperación. También hay que mirar en la carpeta de spam.
- Consultar la página de estado del hosting. Si el proveedor tiene una incidencia, ningún cambio en el sitio servirá de nada.
- Hacer una copia del estado actual, si el hosting lo pone fácil. Parece contradictorio, pero protege en caso de que un intento de arreglo empeore las cosas y conserva los pedidos o formularios recibidos desde la última copia.
A partir de ahí, se aplica la regla que más tiempo ahorra en cualquier diagnóstico: no adivinar, localizar primero el mensaje de error. Una pantalla en blanco oculta la causa, pero WordPress y el servidor casi siempre la dejan anotada en algún sitio.
Encontrar el error real
Hay tres lugares donde buscar, del más sencillo al más técnico.
1. El correo del modo de recuperación
Desde la versión 5.2, cuando WordPress se encuentra con un error fatal al cargar una página, muestra el aviso de "error crítico" y envía un correo al administrador. El mensaje indica el plugin o tema implicado, incluye los detalles del error y contiene un enlace especial para entrar en modo de recuperación. En ese modo, la extensión defectuosa queda en pausa solo para quien accede por el enlace, de forma que se puede llegar al escritorio, desactivarla y salir. Los visitantes siguen viendo el error hasta que se corrige.
El correo llega a la dirección configurada en Ajustes > Generales, así que debe estar al día y el sitio tiene que poder enviar correos de forma fiable.
2. El registro de depuración de WordPress
Si no hay correo, se puede activar el registro de errores del propio WordPress. Hay que abrir wp-config.php en la carpeta raíz del sitio (con el gestor de archivos del hosting o por SFTP) y añadir estas líneas por encima de la que dice "That's all, stop editing!":
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
Si WP_DEBUG ya está definido como false, basta con cambiar esa línea en lugar de añadir otra. Después se recarga la página que falla y se abre wp-content/debug.log. Al final del archivo hay que buscar una línea que empiece por "PHP Fatal error": indica el archivo y la línea que han fallado, y la ruta de la carpeta revela a qué plugin o tema pertenecen, por ejemplo wp-content/plugins/nombre-del-plugin/....
Con esta configuración los errores se guardan en el archivo sin mostrarse a los visitantes. Aun así, conviene desactivar la depuración (volviendo a poner WP_DEBUG en false) y borrar debug.log una vez resuelto el problema: el archivo puede revelar detalles del sitio, y el registro ralentiza un poco la carga.
3. El registro de errores del servidor
En los errores 500 que se producen antes incluso de que cargue WordPress, la respuesta está en el registro de errores del servidor. La mayoría de los paneles de hosting tienen una sección de "Registro de errores" o "Logs"; en otros, el archivo está en la raíz del sitio o en una carpeta logs. Hay que buscar las entradas que coincidan con la hora de la petición fallida. Los mensajes que mencionan .htaccess, permisos o "premature end of script" apuntan a causas del servidor, no al código de WordPress.
Causas habituales y cómo resolverlas
Conviene revisarlas en este orden, que va aproximadamente de la más frecuente a la menos.
Un plugin
El sospechoso habitual, sobre todo justo después de una actualización. Si el mensaje de error nombra un plugin, se desactiva ese. Si no hay acceso al escritorio:
- Con acceso a los archivos, se cambia el nombre de la carpeta del plugin en
wp-content/plugins(añadiendo-off). WordPress lo desactiva automáticamente. - Si no se sabe cuál es, se puede renombrar la carpeta
pluginscompleta comoplugins-off. Si el sitio vuelve, se le devuelve el nombrepluginsy se reactivan los plugins uno a uno desde el escritorio hasta que reaparezca el error. El último activado es el culpable. - Con WP-CLI:
wp plugin deactivate nombre-del-plugin, owp plugin deactivate --allpara probarlos todos a la vez.
Una vez identificado, se puede volver a la versión anterior, avisar al desarrollador o sustituir el plugin.
El tema
Si desactivar los plugins no basta, toca probar el tema. Al renombrar la carpeta del tema activo en wp-content/themes, WordPress recurre a un tema por defecto, como Twenty Twenty-Five, si hay alguno instalado. Si el sitio carga, la causa es el tema (o una edición del tema hijo, a menudo en functions.php). Precisamente por eso conviene tener siempre instalado al menos un tema por defecto.
Falta de memoria
Una línea del registro con "Allowed memory size of ... bytes exhausted" significa que PHP se ha quedado sin memoria. Por defecto, WordPress solicita 40 MB para la parte pública (64 MB en multisitio) y 256 MB para el escritorio. La cifra de la parte pública puede aumentarse en wp-config.php:
define( 'WP_MEMORY_LIMIT', '256M' );
Esto solo funciona hasta el límite que el hosting fija para PHP. Si el error sigue mostrando la misma cifra, hay que pedir al proveedor que aumente el memory_limit de PHP o cambiarlo desde el panel. Y más memoria es un parche: si un plugin necesita de repente mucha más que antes, el problema está en ese plugin.
La versión de PHP
Si el hosting ha actualizado PHP hace poco, o se ha hecho desde el panel, los plugins y temas antiguos pueden usar código que las versiones nuevas ya no aceptan. El registro de depuración mostrará errores como "Call to undefined function". La solución rápida es volver a la versión anterior de PHP desde el panel del hosting; la definitiva, actualizar o sustituir el código desfasado y volver a subir de versión.
Un .htaccess dañado
En servidores Apache y LiteSpeed, una errata en .htaccess (a menudo añadida por un plugin de seguridad o de caché) provoca un error 500 inmediato en todas las páginas. Basta con renombrar el archivo como .htaccess-old y recargar. Si el sitio vuelve, se puede ir a Ajustes > Enlaces permanentes y pulsar Guardar para generar uno limpio, o crearlo con las reglas por defecto de WordPress:
# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
Después se añaden, bloque a bloque, las reglas personalizadas del archivo antiguo. El archivo está oculto por defecto, así que hay que activar la opción de mostrar archivos ocultos en el gestor de archivos o en el programa de FTP.
Permisos de archivo
Tras una migración o una subida manual, unos permisos incorrectos pueden causar errores 500 o páginas en blanco. Los valores estándar son 755 para carpetas y 644 para archivos, con wp-config.php a menudo más restringido (440 o 400, según el hosting). Nunca debe usarse 777, que permite a cualquiera en el servidor escribir en el archivo. En caso de duda, el hosting puede restablecer los permisos; muchos lo hacen con un clic.
Atascado en modo mantenimiento
Si el aviso "Temporalmente no disponible por mantenimiento programado" no desaparece, una actualización se interrumpió y dejó un archivo oculto .maintenance en la raíz del sitio. Se borra, se recarga la web y se repite la actualización que quedó a medias.
Conexión con la base de datos
Ante el "Error al establecer una conexión con la base de datos", hay que comparar el nombre de la base de datos, el usuario, la contraseña y el servidor que figuran en wp-config.php con los del panel de hosting, sobre todo tras una migración o un cambio de contraseña. Si coinciden, puede que el servidor de base de datos esté caído, y eso ya es cosa del proveedor.
Cuando solo falla una parte del sitio
Los fallos parciales son más sencillos, porque acotan la búsqueda.
- Solo el escritorio está en blanco. El escritorio carga más código que la parte pública y usa otro límite de memoria. Hay que buscar errores de memoria en el registro y sospechar de los plugins que añaden páginas de administración: maquetadores, suites de SEO, paneles de analítica. Aumentar
WP_MAX_MEMORY_LIMIT(el techo del escritorio) puede ayudar, siempre dentro del límite de PHP del hosting. - Solo la parte pública está en blanco. El tema gana peso como sospechoso, junto con la caché. Antes que nada, conviene vaciar la caché del plugin, la del servidor y la de la CDN: puede que se esté viendo una copia guardada de un error que ya no existe.
- Solo falla una página o una acción. Un proceso de pago que devuelve un error 500, o una página con un bloque o shortcode concreto que se queda en blanco, suele apuntar al plugin que da esa función. Al reproducir el fallo con el registro de depuración activo, la línea del error lo identificará.
- El error solo lo ven los usuarios conectados, o solo una persona. Hay que probar con una ventana privada y otro navegador. Si el error desaparece, la causa puede ser una extensión del navegador, una cookie antigua o una capa de caché que sirve una copia correcta a los visitantes no conectados.
Cuándo restaurar una copia o llamar al hosting
Corregir la causa suele ser mejor que restaurar, porque la restauración descarta todo lo ocurrido desde la copia: pedidos nuevos, comentarios, formularios, ediciones. Pero hay situaciones en las que es lo más sensato.
Conviene restaurar una copia cuando:
- No se encuentra la causa en una media hora y el sitio pierde ingresos por cada hora sin funcionar.
- Se han roto varias cosas a la vez, por ejemplo tras una gran tanda de actualizaciones o una migración fallida.
- Un plugin ha ejecutado una actualización de la base de datos que no se puede deshacer.
- Aparecen señales de un hackeo: archivos desconocidos, código ajeno al principio de los archivos PHP, nuevos usuarios administradores. En ese caso, hay que restaurar una copia anterior a la infección, cambiar todas las contraseñas y actualizarlo todo.
En una tienda, conviene exportar los pedidos recientes antes de restaurar, o restaurar solo los archivos y conservar la base de datos actual si el problema estaba claramente en el código.
Hay que recurrir al hosting cuando:
- El registro de errores del servidor menciona límites de recursos, procesos interrumpidos o tiempos de espera que no se pueden modificar.
- Los errores 502, 503 o 504 continúan después de descartar los plugins.
- El servidor de base de datos no responde.
- No hay forma de acceder a los archivos.
Al contactar con el soporte, conviene indicar la hora exacta del error, la URL, lo que ya se ha probado y las líneas del registro relevantes. Un aviso concreto obtiene una respuesta más rápida y mejor que un simple "mi web no funciona".
Cómo evitar la próxima
La mayoría de las pantallas en blanco se remontan a un cambio, así que la prevención coincide con la rutina que describe el resto de esta serie:
- Probar los cambios importantes en staging: actualizaciones principales, plugins nuevos que afecten al pago o al diseño, cambios de versión de PHP.
- Mantener copias de seguridad diarias fuera del servidor y probar una restauración de vez en cuando.
- Tener al día el correo del administrador, para que los avisos del modo de recuperación lleguen a alguien que los lea.
- Conservar un tema por defecto instalado como alternativa, y mantener las personalizaciones en un tema hijo.
- Eliminar los plugins que no se usan o están abandonados. Menos plugins, menos conflictos.
- Activar la monitorización de disponibilidad. Un servicio gratuito que compruebe el sitio cada pocos minutos y avise por correo permite enterarse de un error 500 por un robot, no por un cliente.
- Anotar los cambios. Cuando algo falla, la primera pregunta es "¿qué ha cambiado?", y un registro la responde en segundos.
Lista de comprobación
Conviene tenerla a mano para el día en que la web no responda.
- Anotar qué aparece (error crítico, página en blanco, error 500, otro código) y dónde (todo el sitio, el escritorio, una página).
- Preguntarse qué ha cambiado últimamente y consultar la página de estado del hosting.
- Buscar el correo del modo de recuperación; si está, usar el enlace y desactivar el plugin o tema que menciona.
- ¿No hay correo? Activar
WP_DEBUG_LOG, recargar y leer el último error fatal enwp-content/debug.log. - ¿Error 500 sin nada en el registro de depuración? Revisar el registro del servidor y renombrar
.htaccess. - Desactivar el plugin que aparece en el error, o todos a la vez renombrando la carpeta.
- ¿Sigue sin funcionar? Renombrar la carpeta del tema activo para pasar a un tema por defecto.
- Errores de memoria: aumentar
WP_MEMORY_LIMITdentro del límite del hosting y averiguar qué plugin consume tanto. - Tras un cambio de PHP: volver a la versión anterior y después actualizar o sustituir el código desfasado.
- ¿Sin avances tras media hora en un sitio crítico para el negocio? Restaurar la copia o llamar al hosting.
- Al terminar: desactivar la depuración, borrar
debug.log, vaciar cachés y anotar lo ocurrido.
Las herramientas cambian de un caso a otro, pero el método es siempre el mismo: no adivinar, localizar primero el mensaje de error. En la gran mayoría de los casos, el propio mensaje indica dónde mirar.
Fuentes
- WordPress Developer Resources, Debugging in WordPress:
WP_DEBUG,WP_DEBUG_LOG,WP_DEBUG_DISPLAYy la configuración de depuración recomendada - WordPress.org, Recovery Mode y Make WordPress Core, Fatal error recovery mode in 5.2
- DreamHost, How to fix the WordPress memory exhausted error: valores por defecto de
WP_MEMORY_LIMITy límite de PHP del servidor - Themeisle, WordPress file permissions: valores estándar 755/644 y
wp-config.php - Kinsta, Briefly unavailable for scheduled maintenance: el archivo
.maintenance