Cómo solucionar la pantalla blanca de la muerte (WSOD) en WordPress

    ¿Qué es la pantalla blanca de la muerte?

    La pantalla blanca de la muerte (WSOD, por sus siglas en inglés) es uno de los errores más comunes de WordPress. Su sitio muestra una página completamente en blanco sin ningún mensaje de error, lo que dificulta el diagnóstico. Generalmente es causada por un error fatal de PHP o por el agotamiento del límite de memoria.

    Causas comunes

    • Un plugin o tema defectuoso
    • Agotamiento del límite de memoria PHP
    • Errores de sintaxis en archivos del tema o plugins
    • Archivos del núcleo de WordPress corruptos
    • Versión de PHP incompatible

    Paso 1: Activar el modo de depuración de WordPress

    Conéctese a su cuenta de hosting a través del Administrador de archivos en cPanel o por FTP/SFTP, y edite el archivo wp-config.php en el directorio raíz de WordPress. Busque la línea:

    define('WP_DEBUG', false);

    Reemplácela con:

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

    Esto escribirá los errores en wp-content/debug.log en lugar de mostrar una página en blanco. Revise este archivo para obtener mensajes de error específicos.

    Paso 2: Aumentar el límite de memoria PHP

    Agregue o edite la siguiente línea en wp-config.php:

    define('WP_MEMORY_LIMIT', '256M');

    Alternativamente, agregue esto a su archivo .htaccess:

    php_value memory_limit 256M

    Si la WSOD fue causada por agotamiento de memoria, esto debería resolverlo.

    Paso 3: Desactivar todos los plugins

    Si el problema persiste, es probable que un plugin sea la causa. Para desactivar todos los plugins sin acceder a wp-admin:

    1. Abra el Administrador de archivos en cPanel o conéctese por FTP.
    2. Navegue a wp-content/.
    3. Renombre la carpeta plugins a plugins_disabled.
    4. Recargue su sitio. Si carga correctamente, un plugin es el problema.
    5. Renombre la carpeta de vuelta a plugins.
    6. Reactive los plugins uno por uno desde wp-admin para identificar el defectuoso.

    Paso 4: Cambiar a un tema predeterminado

    Si desactivar los plugins no ayuda, cambie a un tema predeterminado de WordPress:

    1. Navegue a wp-content/themes/.
    2. Renombre la carpeta de su tema activo (ej.: mitema → mitema_disabled).
    3. WordPress cambiará automáticamente a un tema predeterminado (Twenty Twenty-Five, etc.).
    4. Si el sitio carga, el problema está en su tema.

    Paso 5: Resubir los archivos del núcleo de WordPress

    Si nada de lo anterior funciona, los archivos del núcleo pueden estar corruptos:

    1. Descargue una copia nueva de WordPress desde wordpress.org.
    2. Extraiga el archivo ZIP.
    3. Suba las carpetas wp-admin y wp-includes a su servidor, sobrescribiendo las existentes.
    4. No sobrescriba la carpeta wp-content ni el archivo wp-config.php.

    Paso 6: Verificar compatibilidad de la versión de PHP

    En cPanel, vaya a Select PHP Version (o MultiPHP Manager) y asegúrese de que su sitio esté ejecutando una versión de PHP compatible con su versión de WordPress. WordPress 6.x requiere PHP 7.4 o superior (se recomienda PHP 8.1+).

    publicado