Cómo arreglar pantalla blanca en PrestaShop | WSOD

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido WSOD (White Screen of Death) o pantalla blanca en PrestaShop. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía extensa y paso a paso, te voy a explicar qué es, por qué ocurre y cómo solucionarlo tú mismo, sin necesidad de ser un experto en programación.

Vamos a empezar.

¿Qué es la pantalla blanca en PrestaShop (WSOD)?

La pantalla blanca PrestaShop es exactamente lo que parece: en lugar de ver tu tienda online o el panel de administración, solo ves una página en blanco. Sin mensajes de error, sin texto, absolutamente nada. Esto sucede porque PHP (el lenguaje en el que está escrito PrestaShop) encuentra un error crítico y, por seguridad, deja de mostrar cualquier cosa.

A esto se le conoce técnicamente como WSOD PrestaShop (White Screen of Death). Es frustrante, pero no es el fin del mundo. Vamos a diagnosticarlo y repararlo.

Causas más comunes del error página blanca en PrestaShop

Antes de lanzarnos a las soluciones, es bueno saber qué suele provocarlo. Las causas más frecuentes son:

Módulos incompatibles o corruptos: Un módulo recién instalado o actualizado puede estar dando problemas.
Límite de memoria PHP insuficiente: Si tu tienda crece y el límite de memoria es bajo, PHP se queda sin recursos y se bloquea.
Errores de sintaxis en archivos: Al editar un archivo (por ejemplo, .htaccess, config/defines.inc.php o un tema), podemos dejar un error tipográfico.
Tema defectuoso o incompatible: Un tema mal diseñado o desactualizado puede causar el bloqueo.
Problemas con la base de datos: A veces una tabla corrupta o un error en una consulta genera la pantalla blanca.
Actualización fallida de PrestaShop: Si la actualización se interrumpió, puede dejar el sistema en un estado inconsistente.

Diagnóstico inicial: ¿Qué está fallando?

Lo primero es intentar obtener algo de información. Como no vemos nada, tenemos que hacer "ingeniería inversa".

1. Activar el modo debug de PrestaShop

El modo debug es tu mejor amigo. Te mostrará el error real en lugar de la pantalla blanca.

Pasos para hacerlo:

Accede a tu servidor mediante FTP o al administrador de archivos de tu hosting (cPanel, Syspanel, etc.).
Busca la carpeta raíz de tu PrestaShop (donde están las carpetas admin, config, modules, etc.).
Ubica el archivo config/defines.inc.php.
Descarga una copia de seguridad por si acaso.
Ábrelo con un editor de texto plano (como Notepad++ o el bloc de notas, nunca Word).
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda el archivo y súbelo de nuevo al servidor (sobrescribiendo el original).

Ahora, al recargar tu tienda o el panel de administración, deberías ver un mensaje de error detallado con el nombre del archivo, la línea y una descripción del problema. ¡Eso es oro puro!

[INFO] Si no ves ningún cambio, prueba también a buscar la línea define('_PS_DISPLAY_COMPRESSION_', false); y cámbiala a true. O añade justo después de la línea anterior: ini_set('display_errors', 1);.

2. Revisar los logs del servidor

Si el modo debug no te da suficiente información (a veces el error es tan grave que ni siquiera se ejecuta), toca mirar los logs.

En cPanel: Busca la sección "Errores" o "Registros de errores" (Apache Error Log).
En Syspanel (HestiaCP): Accede a Syspanel a través de tu-dominio.com:2106 (el puerto 2106 es importante). Dentro, ve a "Web" > "Logs" y busca el log de errores de tu sitio.
En otros paneles: Busca "Error Log" o "Registro de errores".

Los logs suelen mostrar la línea exacta y el archivo que causa el problema. Anota esa información.

Soluciones paso a paso según el error

Una vez que tienes el mensaje de error (o al menos una pista), aplica la solución correspondiente.

Solución 1: Aumentar el límite de memoria PHP

Si el error dice algo como "Allowed memory size of X bytes exhausted", necesitas más memoria.

¿Cómo hacerlo?

Desde el panel de control (recomendado):
- En cPanel: Ve a "Seleccionar versión de PHP" (o MultiPHP INI Editor) y aumenta memory_limit a 256M o 512M.
- En Syspanel (HestiaCP): Accede a Syspanel (tu-dominio.com:2106), ve a "Web" > tu dominio > "Configuración avanzada de PHP" y modifica memory_limit. Guarda los cambios.
Editando el archivo php.ini (si tienes acceso):
- Busca el archivo php.ini en la raíz de tu sitio o en una carpeta pública.
- Busca la línea memory_limit y cámbiala a memory_limit = 256M.
- Si no existe, créala.
A través del archivo .htaccess:
- Abre el archivo .htaccess en la raíz de PrestaShop.
- Añade esta línea al final: php_value memory_limit 256M.

[WARNING] Si aumentas la memoria demasiado, puede afectar al rendimiento del servidor. 256M suele ser suficiente para la mayoría de tiendas. 512M es para tiendas muy grandes.

Solución 2: Deshabilitar módulos problemáticos

Si el error menciona un módulo concreto (por ejemplo, "en la línea X del módulo 'supermodulo'"), ese es el culpable.

Pasos para deshabilitarlo sin acceso al panel:

Conéctate por FTP o al administrador de archivos.
Ve a la carpeta modules/ dentro de tu PrestaShop.
Busca la carpeta del módulo problemático (por ejemplo, supermodulo).
Renombra la carpeta añadiendo algo como _old al final (ejemplo: supermodulo_old). Esto desactiva el módulo por completo.
Recarga tu tienda. Si el problema desaparece, ya sabes qué módulo es.

Si no sabes qué módulo es, puedes deshabilitarlos todos temporalmente:

Ve a la carpeta modules/.
Renombra la carpeta modules a modules_backup.
Crea una nueva carpeta vacía llamada modules.
Recarga la tienda. Si funciona, el problema es de algún módulo.
Para restaurar, borra la carpeta modules vacía y renombra modules_backup a modules de nuevo. Luego, ve activando módulos de uno en uno desde el panel de administración (si logras acceder) para encontrar el culpable.

Solución 3: Revertir cambios recientes en el tema o archivos

Si el error apareció después de editar un archivo de tema (como header.tpl, footer.tpl o el global.css), o después de modificar el .htaccess, revierte esos cambios.

Si tienes copia de seguridad: Restaura el archivo original.
Si no tienes copia: Descarga una copia limpia de PrestaShop de la misma versión que tienes y extrae el archivo original de la carpeta themes/default-bootstrap (o el nombre de tu tema) o de la raíz.

Solución 4: Reconstruir el archivo .htaccess

Un .htaccess corrupto es una causa frecuente.

Conéctate por FTP.
Busca el archivo .htaccess en la raíz de PrestaShop.
Renómbralo a .htaccess_old.
Recarga tu tienda. Si funciona, el problema era el .htaccess.
Para regenerar uno nuevo:
- Accede al panel de administración de PrestaShop (si puedes).
- Ve a "Configuración de la tienda" > "Tráfico y SEO" > "SEO y URLs".
- Haz clic en "Guardar" sin cambiar nada. Esto regenera el archivo.
- Si no puedes acceder al panel, descarga un PrestaShop limpio, copia el .htaccess de la carpeta raíz y súbelo a tu servidor. Luego, edítalo para que coincida con tu dominio (cambia RewriteBase / si es necesario).

Solución 5: Reparar la base de datos

Si el error menciona la base de datos (por ejemplo, "MySQL server has gone away" o "Table XXX is marked as crashed"), necesitas repararla.

Desde Syspanel (HestiaCP):

Accede a Syspanel (tu-dominio.com:2106).
Ve a "Bases de datos" > phpMyAdmin.
Selecciona tu base de datos.
En la parte inferior, marca "Seleccionar todo" y en el menú desplegable elige "Reparar tabla".

Desde cPanel:

Ve a "Bases de datos MySQL" > phpMyAdmin.
Selecciona la base de datos.
Marca todas las tablas y elige "Reparar tabla".

Solución 6: Reinstalar PrestaShop (último recurso)

Si nada funciona y tienes una copia de seguridad de tu base de datos y archivos, puedes reinstalar PrestaShop.

Haz una copia de seguridad COMPLETA de tu base de datos y de la carpeta de archivos.
Descarga la misma versión de PrestaShop que tenías.
Sube todos los archivos (excepto la carpeta install y el archivo settings.inc.php si quieres conservar la configuración) a tu servidor, sobrescribiendo los existentes.
Si decides reinstalar desde cero, elimina todo y sube los archivos limpios.
Sigue el proceso de instalación. Al final, no borres la carpeta install si quieres mantener la configuración antigua (aunque no es recomendable para seguridad).

[WARNING] Reinstalar borrará cualquier personalización que hayas hecho en los archivos del núcleo. Siempre prioriza las soluciones anteriores.

Preguntas Frecuentes (FAQ)

¿Por qué mi PrestaShop se queda en blanco después de una actualización?

Es muy común. Las actualizaciones pueden dejar archivos obsoletos o módulos incompatibles. Activa el modo debug (como explicamos arriba) para ver el error exacto. Luego, desactiva todos los módulos no oficiales y restaura el tema por defecto.

¿Puedo acceder al panel de administración si tengo la pantalla blanca?

A veces sí, a veces no. Si el error está en el front office (la tienda) pero el back office (admin) funciona, puedes deshabilitar módulos desde allí. Si el error está en ambos, tendrás que usar FTP o el panel de control.

¿Qué hago si no puedo acceder ni por FTP ni por el panel de control?

Contacta con tu proveedor de hosting. Ellos tienen acceso root y pueden ayudarte a restaurar archivos o activar el modo debug desde su lado.

¿El WSOD puede deberse a un ataque de seguridad?

Sí, aunque es menos común. Un archivo malicioso puede sobrescribir archivos críticos. Si después de solucionar el error notas comportamientos extraños (redirecciones, ventanas emergentes, etc.), escanea tu sitio con un plugin de seguridad o contacta a un experto.

Consejos finales para evitar la pantalla blanca

Haz copias de seguridad periódicas: Tanto de archivos como de base de datos. Así, si algo falla, puedes volver atrás en minutos.
Prueba en un entorno de desarrollo: Antes de instalar módulos o temas nuevos, pruébalos en una copia local o en un subdominio de pruebas.
Mantén PrestaShop, módulos y temas actualizados: Las actualizaciones corrigen errores y vulnerabilidades.
No edites archivos del núcleo: Si necesitas personalizar algo, usa un tema hijo o un módulo de personalización.
Configura un límite de memoria adecuado desde el principio: 128M es el mínimo, 256M es lo recomendado para tiendas con varios módulos.

Recuerda, la pantalla blanca PrestaShop es un problema técnico, pero no es personal. Con paciencia y siguiendo estos pasos, lo solucionarás. Si te atascas, no dudes en pedir ayuda a tu hosting o a un desarrollador. ¡Tu tienda volverá a estar online en poco tiempo!

Espero que esta guía te haya sido de gran ayuda. Si tienes más dudas, aquí estoy para ayudarte. ¡Mucho ánimo!