La pantalla blanca de WordPress de la muerte
Una página completamente en blanco sin error y sin HTML. PHP paró la mitad de la investigación y el mensaje fue a un registro que no ha leído todavía.
(a blank white page, no text at all)
La pantalla está en blanco porque display_errors está apagado, no porque no hay nada que decir. Enciende WP_DEBUG_LOG, vuelva a cargar la página una vez, y lea wp-content/debug.log - la última entrada nombres el archivo y la línea que paró.
Las causas más probables primero.
Revisa la lista en orden. Cada comprobación permite confirmar o descartar una causa antes de hacer cambios: las soluciones son distintas y adivinar cuesta más que ejecutar un comando.
| Causa | Cómo comprobarlo | Solución |
|---|---|---|
| Un error de PHP fatal en un plugin o tema | La entrada de registro comienza con "error de PhP Fatal" y nombre un archivo bajo wp-content. Esa ruta es la respuesta. | Desactiva el plugin o el tema de conmutación nombrado. Si el archivo pertenece a un tema, cambiar a un tema predeterminado restaura el sitio mientras lo mira. |
| Se alcanzó el límite de memoria | El registro dice "El tamaño de la memoria ... agotado". Una página en blanco y una muerte fuera de memoria parecen idénticos del navegador. | Elevar el límite suficiente para cargar la página, y luego encontrar lo que necesitaba la memoria. El límite es un síntoma, no la causa. |
| Sólo wp-admin es blanco | El extremo frontal se renderiza y el dashboard no, o el reverso. Ese asimetría apunta a código sólo para administración. | El fatal está en un solo camino de administración. Renombrar el directorio de plugins sobre SFTP para volver a entrar, luego reactivar uno a la vez. |
| OPcache está sirviendo un archivo compilado de establo | El sitio estaba bien, se editó un archivo, y ahora está en blanco - y el error nombra una línea que ya no existe en el archivo. | Flush OPcache. Editar PHP en su lugar sin un flujo deja la versión compilada y la fuente en desacuerdo. |
| Un error de sintaxis en un archivo que acaba de editar | php -l en el archivo que tocaste los últimos informes del error sin necesidad de WordPress en absoluto. | Fijar la sintaxis o restaurar la copia anterior. Un braceo estrado en wp-config .php o functions.php derriba cada página de inmediato. |
Solución paso a paso.
Los comandos requieren WP-CLI y acceso a la consola. Si no los tienes, cada paso explica cómo hacer lo mismo desde el panel o por SFTP.
Enciende el mensaje
Registro en lugar de mostrar: desea el detalle sin publicar un rastro de pila a los visitantes.
wp config set WP_DEBUG true --raw wp config set WP_DEBUG_LOG true --raw wp config set WP_DEBUG_DISPLAY false --raw
Recargar la página en blanco una vez, luego leer el registro
La última entrada es tuya. Todo por encima puede ser ruido viejo.
tail -n 30 wp-content/debug.log
Si se llama un plugin, tome ese plugin fuera de la solicitud
Desactivar por nombre es suficiente; no necesita borrar nada.
wp plugin deactivate the-named-plugin
Si no puede alcanzar wp-admin en absoluto, deshabilitar plugins del sistema de archivos
Renaming el directorio hace que WordPress no encuentra plugins, lo cual es suficiente para recuperar el dashboard.
mv wp-content/plugins wp-content/plugins.off
Apaga el depuro cuando termines
Un registro de depuración que queda en crece sin límite y registra caminos que preferiría no publicar.
wp config set WP_DEBUG false --raw
De esto se encarga la plataforma.
La pantalla blanca es un accidente de configuración en lugar de una función de WordPress: PHP se le dice que no muestre errores y nada se le dice que los log. Aquí el registro está encendido y writable desde la primera solicitud, por lo que un error fatal es una línea que se puede leer en lugar de una página vacía. Cerrar el sitio antes de una actualización significa el plugin que fatales lo hace en una copia que nadie está visitando.
Preguntas frecuentes.
¿Por qué la página está en blanco en lugar de mostrar el error?
El extremo delantero está bien pero wp-admin es blanco. ¿Por qué sólo allí?
Arreglé el archivo pero la página sigue en blanco.
¿Puedo encontrar al culpable sin ningún acceso a línea de comando?
Si el problema era otro.
Estos errores pueden parecerse en el navegador.