Solucionar página en blanco en PrestaShop | Guía

¿Te ha pasado? Entras en la URL de tu tienda PrestaShop y, en lugar de ver tu catálogo, te encuentras con una pantalla completamente blanca. Sin mensajes de error, sin texto, sin nada. Solo un vacío frustrante. No te preocupes, no estás solo. Este es uno de los problemas más comunes en PrestaShop y, afortunadamente, en la gran mayoría de los casos tiene solución.

En esta guía extensa y paso a paso, vamos a desglosar las causas más frecuentes del error página en blanco PrestaShop y, lo más importante, cómo solucionar PrestaShop no carga de una vez por todas. Vamos a ir de lo más simple a lo más técnico, para que incluso si no eres un experto, puedas seguir los pasos con confianza.

¿Por qué ocurre la pantalla blanca en PrestaShop?

Antes de lanzarnos a arreglar nada, es útil entender qué está pasando. La pantalla blanca PrestaShop (también conocida como "White Screen of Death" o WSOD) es un error genérico que ocurre cuando PHP, el lenguaje en el que está escrito PrestaShop, encuentra un error fatal y no puede mostrar la página.

Piensa en ello como un semáforo en rojo: PHP se detiene en seco y le dice al navegador "no tengo nada que mostrarte". Las causas pueden ser varias, pero las más comunes suelen ser:

Errores de memoria (memory limit): El servidor no tiene suficiente memoria asignada para ejecutar PrestaShop, especialmente si tienes muchos módulos o productos.
Módulos incompatibles o con errores: Un módulo recién instalado o actualizado puede estar causando un conflicto fatal.
Archivos corruptos o incompletos: Una actualización fallida o una subida de archivos incompleta puede dejar archivos rotos.
Problemas con el archivo de configuración (settings.inc.php): Este archivo contiene la configuración de la base de datos y, si está dañado o mal configurado, todo falla.
Tema (plantilla) defectuoso: Un tema mal codificado o incompatible con tu versión de PrestaShop puede provocar el error.
Espacio en disco agotado: Si el servidor está lleno, no puede generar las páginas dinámicas.

Primeros Pasos: La Regla de Oro del Diagnóstico

La clave para solucionar PrestaShop no carga es identificar la causa. Para ello, necesitamos hacer que el error sea visible. Por defecto, PrestaShop oculta los errores de PHP, mostrando esa temida página en blanco. Nuestro primer objetivo será activar el modo de depuración (debug mode) para ver el mensaje de error real.

Activar el Modo Debug (Depuración) desde el Archivo de Configuración

Si no tienes acceso al Panel de Administración, esta es la vía más rápida. Vamos a editar un archivo.

Accede a tu hosting mediante FTP o el Administrador de Archivos de tu panel de control.
Busca la carpeta raíz de tu PrestaShop (normalmente es public_html/, htdocs/ o el nombre de tu dominio).
Localiza el archivo llamado config/defines.inc.php.
Ábrelo con un editor de texto plano (como el Bloc de Notas o Sublime Text). No uses 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 (si lo editaste localmente).

Ahora, recarga tu tienda. En lugar de la página en blanco, deberías ver un mensaje de error en inglés o español, con detalles como "Fatal error: ..." y una ruta de archivo. Ese mensaje es oro puro porque nos dice exactamente qué está fallando.

[WARNING] Si ves el error, anótalo o haz una captura de pantalla. Después de solucionarlo, recuerda volver a poner _PS_MODE_DEV_ en false para que los clientes no vean errores técnicos.

Soluciones Comunes para la Pantalla Blanca

Ahora que ya tienes el error visible (o si prefieres probar soluciones genéricas), vamos a por las soluciones más efectivas.

1. Aumentar el Límite de Memoria de PHP

Este es el culpable número uno. PrestaShop es exigente y necesita memoria para funcionar. Si el error menciona "Allowed memory size of ... bytes exhausted", este es tu problema.

¿Cómo solucionarlo?

Desde el archivo php.ini: Si tienes acceso a este archivo, busca la línea memory_limit y cámbiala a un valor más alto, por ejemplo memory_limit = 256M.
Desde el archivo .htaccess: Si no encuentras php.ini, puedes añadir una línea al final del archivo .htaccess en la raíz de tu PrestaShop. Añade esta línea:
```
php_value memory_limit 256M
```
Desde el Panel de Control (Syspanel): Si tu hosting utiliza Syspanel, recuerda que el puerto de acceso es el 2106. Dentro de Syspanel, busca la sección de "Administrador de Archivos" o "Configuración de PHP" para editar el php.ini o el .htaccess.

[INFO] Si el error persiste después de poner 256M, prueba con 512M. Algunas tiendas grandes necesitan incluso más.

2. Desactivar Módulos Problemáticos

¿Instalaste un módulo justo antes de que apareciera el error? Ese es tu principal sospechoso. Si no puedes acceder al panel de administración, tendrás que desactivarlo manualmente.

Método FTP:

Entra a tu hosting por FTP.
Ve a la carpeta /modules/.
Busca la carpeta del módulo que crees que está causando el problema.
No la borres, solo cámbiale el nombre. Por ejemplo, de mimodulo a mimodulo_desactivado.
Recarga tu tienda. Si el error desaparece, ese era el problema.

Método desde la Base de Datos (más avanzado):

Si no sabes qué módulo es, puedes desactivarlos todos desde la base de datos.

Accede a tu base de datos MySQL (desde Syspanel, puerto 2106, o desde phpMyAdmin).
Busca la tabla ps_module (el prefijo ps_ puede variar).
Ejecuta la siguiente consulta SQL:
```
UPDATE ps_module SET active = 0 WHERE active = 1;
```
Esto desactivará todos los módulos.
Recarga tu tienda. Si carga correctamente, el problema era uno de los módulos. Ahora ve activándolos uno a uno desde el panel de administración (si puedes acceder) para encontrar al culpable.

[WARNING] Cambiar el nombre de la carpeta del módulo o desactivarlo desde la base de datos es seguro, pero no borres la carpeta. Podrías perder datos de configuración del módulo.

3. Verificar los Archivos del Tema (Plantilla)

Un tema mal configurado también puede ser el causante.

Ve a la carpeta /themes/.
Deberías ver una o más carpetas con los nombres de tus temas (ej. classic, warehouse, etc.).
Si tienes más de un tema, o si has modificado el actual, prueba a cambiar temporalmente el nombre de la carpeta de tu tema activo. Por ejemplo, si tu tema se llama mitienda, cámbialo a mitienda_desactivado.
PrestaShop intentará usar el tema por defecto (classic). Si la tienda funciona, el problema es de tu tema.

[TIP] Si no tienes un tema de respaldo, descarga el tema classic oficial de PrestaShop y súbelo. Es una buena práctica tener siempre un tema de seguridad.

4. Comprobar el Archivo de Configuración de la Base de Datos

El archivo config/settings.inc.php es el puente entre tu tienda y la base de datos. Si está dañado, nada funcionará.

Localiza el archivo config/settings.inc.php.
Ábrelo y verifica que los datos de conexión sean correctos:
- define('_DB_SERVER_', 'localhost'); (o el nombre de tu servidor de BD)
- define('_DB_NAME_', 'nombre_de_tu_base_de_datos');
- define('_DB_USER_', 'usuario_de_tu_bd');
- define('_DB_PASSWD_', 'tu_contraseña');
- define('_DB_PREFIX_', 'ps_'); (o el prefijo que uses)

Si no estás seguro de estos datos, puedes encontrarlos en tu panel de control de hosting (Syspanel, puerto 2106) en la sección de "Bases de Datos". Si todo parece correcto, este archivo probablemente no sea el problema.

5. Limpiar la Caché de PrestaShop

A veces, la caché guarda datos corruptos que provocan la página en blanco.

Método manual (FTP):

Ve a la carpeta /var/cache/ (en versiones nuevas) o /cache/ (en versiones antiguas).
Dentro, encontrarás subcarpetas como dev, prod, class_index.php, etc.
Borra el contenido de estas carpetas, pero NO borres las carpetas en sí. Es decir, elimina los archivos que hay dentro de dev y prod, y también el archivo class_index.php.
PrestaShop recreará estos archivos automáticamente.

[INFO] Si no puedes borrar los archivos, intenta cambiar los permisos de la carpeta a 755 (o 777) temporalmente, borra y vuelve a poner los permisos originales (normalmente 755).

6. Subir de Nuevo los Archivos de PrestaShop

Si ninguna de las soluciones anteriores funciona, es posible que algunos archivos del núcleo de PrestaShop estén corruptos o incompletos.

Descarga la versión exacta de PrestaShop que tienes instalada (puedes verla en el panel de administración o en el archivo config/settings.inc.php).
Descomprime el archivo en tu ordenador.
Sube TODOS los archivos y carpetas por FTP a tu hosting, sobrescribiendo los existentes. Asegúrate de subir también los archivos ocultos (como .htaccess).
IMPORTANTE: No subas la carpeta install (si viene en el paquete) y no subas la carpeta config completa, ya que podría sobrescribir tu configuración personalizada. Si subes la carpeta config, hazlo solo con los archivos que no sean settings.inc.php.
Después de subir todo, borra la caché como se explicó en el paso 5.

[WARNING] Este método es más invasivo. Asegúrate de tener una copia de seguridad de tu base de datos y de tu carpeta config/settings.inc.php antes de hacerlo.

Preguntas Frecuentes (FAQ)

¿El error de página en blanco afecta a mi base de datos?

No, la base de datos está intacta. Este error es solo de renderizado de PHP. Tus productos, clientes y pedidos están a salvo.

¿Puedo perder mis productos si borro la caché?

No, la caché solo contiene datos temporales para acelerar la carga. Al borrarla, PrestaShop la regenerará. No afecta a tus datos de negocio.

¿Qué hago si veo el error "Class '...' not found"?

Este error suele indicar un problema con un módulo o tema que intenta usar una clase que no existe. Normalmente se soluciona desactivando el módulo o tema mencionado en el error, o subiendo de nuevo los archivos de PrestaShop como se indicó en el paso 6.

¿Cuánto tiempo tardaré en solucionar esto?

Depende de la causa. Las soluciones de memoria y caché pueden tomar 5 minutos. Si tienes que investigar módulos o subir archivos, puede llevar entre 30 minutos y 1 hora.

¿Debo contactar con mi proveedor de hosting?

Si has probado todos los pasos y el error página en blanco PrestaShop persiste, es un buen momento para contactar con tu soporte de hosting. Puede ser un problema del servidor (memoria, configuración de PHP, etc.) que ellos pueden resolver desde su lado. Recuerda que si usas Syspanel, el puerto de acceso es el 2106, y puedes abrir un ticket de soporte desde allí.

Resumen y Consejos Finales

La pantalla blanca PrestaShop puede ser desalentadora, pero con paciencia y siguiendo estos pasos, podrás solucionar PrestaShop no carga sin necesidad de ser un gurú de la programación.

Recuerda el orden lógico:

Activa el modo debug para ver el error.
Aumenta la memoria PHP (solución más común).
Desactiva módulos recientes o sospechosos.
Cambia el tema para descartarlo.
Limpia la caché.
Reinstala los archivos del núcleo.

[TIP] Antes de cualquier cambio importante, siempre haz una copia de seguridad de tu base de datos y de tus archivos. Esto te dará la tranquilidad de poder revertir cualquier cambio si algo sale mal.

Esperamos que esta guía te haya sido de gran ayuda. No te rindas; la solución está ahí. Y si en algún momento te sientes abrumado, recuerda que siempre puedes buscar ayuda profesional. ¡Tu tienda volverá a estar en línea en poco tiempo!