Cómo Solucionar la Pantalla Blanca en PrestaShop (Backoffice y Frontoffice) Paso a Paso

¿Qué es la Pantalla Blanca en PrestaShop y por qué ocurre?

La temida pantalla blanca (White Screen of Death o WSoD) en PrestaShop ocurre cuando se produce un error crítico de PHP que detiene la ejecución del script, pero la configuración del servidor oculta los detalles del error por seguridad. Esto puede afectar tanto al Frontoffice (la tienda visible para los clientes) como al Backoffice (el panel de administración).

Principales causas del error

• Conflictos o incompatibilidades con módulos de terceros recién instalados o actualizados.
• Agotamiento del límite de memoria RAM asignado a PHP (Memory Limit).
• Errores de sintaxis en archivos modificados del tema o código fuente.
• Incompatibilidad de la versión de PHP con los módulos o la versión de PrestaShop.

Método 1: Activar el Modo Debug para identificar el error exacto

Para saber qué está causando la pantalla blanca, necesitamos ver el mensaje de error real en lugar de una página en blanco. Sigue estos pasos para activar el modo debug:

1. Accede a los archivos de tu servidor mediante un cliente FTP (como FileZilla) o el Administrador de Archivos de tu hosting.
2. Navega hasta la carpeta raíz de tu instalación de PrestaShop.
3. Entra en la carpeta config/ y busca el archivo defines.inc.php.
4. Abre el archivo con un editor de texto y busca la siguiente línea:
   define('_PS_MODE_DEV_', false);
5. Cambia el valor false por true para que quede así:
   define('_PS_MODE_DEV_', true);
6. Guarda los cambios y recarga la página de tu tienda donde aparecía la pantalla blanca. Ahora verás el error detallado de PHP o PrestaShop.

Método 2: Ampliar el Límite de Memoria de PHP

Si el mensaje de error en modo debug menciona un problema de memoria (ej. Allowed memory size exhausted), debes aumentar el límite de memoria asignado a PHP:

1. Accede al panel de control de tu hosting (cPanel o Plesk).
2. Busca la herramienta Seleccionar versión de PHP o MultiPHP INI Editor.
3. Modifica la directiva memory_limit y asígnale un valor superior, como 512M o 1024M.
4. Si tienes acceso al archivo .htaccess en la raíz de PrestaShop, también puedes intentar añadir la siguiente línea:
   php_value memory_limit 512M
5. Guarda los cambios y comprueba si tu tienda vuelve a funcionar con normalidad.

Método 3: Desactivar módulos defectuosos vía Base de Datos

Si la pantalla blanca ocurrió justo después de instalar o actualizar un módulo y no puedes acceder al Backoffice, puedes desactivarlo directamente desde la base de datos:

1. Entra a phpMyAdmin desde el panel de tu hosting.
2. Selecciona la base de datos de tu tienda PrestaShop.
3. Haz clic en la pestaña SQL o busca la tabla llamada ps_module (el prefijo ps_ puede variar según tu instalación).
4. Ejecuta la siguiente consulta SQL para desactivar el módulo problemático (reemplaza 'nombre_modulo' por el nombre real de la carpeta del módulo):
   UPDATE ps_module SET active = 0 WHERE name = 'nombre_modulo';
5. Limpia la caché de PrestaShop eliminando el contenido de las carpetas var/cache/prod/ y var/cache/dev/ mediante FTP.