Página en blanco PrestaShop: Causas y soluciones

¿Qué es la página en blanco en PrestaShop y por qué aparece?

La página en blanco en PrestaShop (también conocida como white screen prestashop o error pantalla blanca prestashop) es uno de los problemas más comunes y frustrantes que puedes encontrar al gestionar tu tienda online.

Imagina que un cliente entra en tu tienda, hace clic en un producto y, de repente, solo ve una pantalla completamente blanca. Sin mensajes de error, sin texto, sin imágenes. Nada.

Este problema puede aparecer tanto en el front office (la parte visible de tu tienda) como en el back office (el panel de administración). Y aunque parece un error grave, la buena noticia es que en la mayoría de los casos tiene solución y no has perdido tus datos.

En esta guía completa, vamos a explicarte paso a paso cómo identificar la causa de la página en blanco prestashop y cómo solucionarla, incluso si no tienes conocimientos técnicos avanzados.

¿Por qué ocurre el white screen en PrestaShop?

El white screen prestashop suele estar causado por un error de PHP que se produce de forma silenciosa. Cuando PrestaShop encuentra un problema grave en el código, en lugar de mostrar un mensaje de error, simplemente no renderiza nada.

Las causas más frecuentes son:

Errores de memoria PHP (límite de memoria excedido)
Módulos incompatibles o mal configurados
Temas (plantillas) con errores
Archivos corruptos o incompletos (por actualizaciones fallidas)
Problemas de permisos en archivos y carpetas
Errores en el archivo de configuración (parameters.php)
Versiones incompatibles de PHP con tu versión de PrestaShop

Vamos a ver cómo solucionar cada uno de estos casos.

Paso 1: Activa el modo de depuración para ver el error real

Lo primero que necesitas hacer es ver el error real que está ocurriendo. Como la pantalla está en blanco, necesitas "obligar" a PrestaShop a que te muestre qué está fallando.

Existen dos formas de hacerlo:

Opción A: Modificar el archivo defines.inc.php

Accede a tu hosting mediante FTP o el administrador de archivos de tu panel de control (como Syspanel, al que accedes por el puerto 2106).

Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www)
Busca la carpeta config
Dentro de ella, encuentra el archivo defines.inc.php
Ábrelo con un editor de texto (como el Bloc de notas o Notepad++)
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

[WARNING] Recuerda que, una vez solucionado el problema, debes volver a cambiar esta línea a false para que tu tienda no muestre errores internos a los clientes.

Opción B: Usar el archivo .htaccess

Si no encuentras el archivo defines.inc.php, también puedes añadir estas líneas al archivo .htaccess que está en la raíz de tu PrestaShop:

php_flag display_errors on
php_value error_reporting 32767

Guarda el archivo y recarga tu tienda. Ahora deberías ver el error específico en lugar de la pantalla blanca.

Paso 2: Aumentar el límite de memoria PHP

Uno de los culpables más habituales de la página en blanco en PrestaShop es el límite de memoria PHP. Cuando tu tienda necesita procesar más datos de los permitidos, PHP se detiene y muestra una pantalla blanca.

Cómo aumentar la memoria PHP

Desde Syspanel (puerto 2106):

Accede a tu panel de control Syspanel escribiendo tu-dominio.com:2106 en tu navegador
Busca la sección de "PHP" o "Configuración de PHP"
Localiza la opción memory_limit
Cámbiala a 256M o incluso 512M
Guarda los cambios y reinicia PHP si es necesario

Desde el archivo .htaccess:

Si no tienes acceso a la configuración de PHP desde tu panel, añade esta línea al .htaccess:

php_value memory_limit 256M

[TIP] PrestaShop 1.7 y versiones posteriores recomiendan al menos 256M de memoria PHP para funcionar correctamente.

Paso 3: Identificar módulos problemáticos

Los módulos son una de las causas más comunes del error pantalla blanca prestashop. Un módulo mal codificado, incompatible o con una configuración incorrecta puede romper toda tu tienda.

¿Cómo saber si un módulo es el culpable?

Si puedes acceder al panel de administración, ve a Módulos > Módulos y Servicios
Ordena los módulos por "Última actualización" o por "Fecha de instalación"
Desactiva los módulos que hayas instalado o actualizado recientemente
Recarga tu tienda después de desactivar cada uno

Si no puedes acceder al panel de administración:

Accede a tu hosting por FTP o administrador de archivos
Navega hasta la carpeta modules
Renombra la carpeta del módulo sospechoso. Por ejemplo, si crees que el problema es el módulo de pago, renombra paymentmodule a paymentmodule_backup
Recarga tu tienda

[WARNING] Si renombras una carpeta de módulo, este quedará desactivado automáticamente. No borres la carpeta, solo renómbrala para poder restaurarla después.

Paso 4: Comprobar el tema (plantilla) de tu tienda

Otro culpable frecuente de la white screen prestashop es el tema que estás utilizando. Un tema mal configurado o con errores en sus archivos puede provocar que la tienda no se muestre.

Probar con el tema por defecto

Accede a tu hosting por FTP
Navega hasta la carpeta themes
Localiza la carpeta de tu tema actual
Renómbrala a algo como mi-tema-backup
Descarga el tema por defecto de PrestaShop (por ejemplo, classic para PrestaShop 1.7)
Súbela a la carpeta themes
Recarga tu tienda

Si la tienda vuelve a funcionar, el problema está en tu tema original. Puedes intentar actualizarlo o contactar con el desarrollador del tema.

Paso 5: Verificar permisos de archivos y carpetas

Los permisos incorrectos pueden causar que PrestaShop no pueda leer o escribir archivos necesarios, lo que resulta en una página en blanco prestashop.

Permisos correctos para PrestaShop

Carpetas (directorios): 755
Archivos: 644
Carpeta var/cache o cache: 755 (debe ser escribible)
Carpeta config: 755
Carpeta log: 755

Cómo cambiar permisos desde Syspanel (puerto 2106)

Accede a Syspanel (tu-dominio.com:2106)
Ve al administrador de archivos
Selecciona la carpeta o archivo que quieres cambiar
Haz clic derecho y elige "Cambiar permisos" o "Chmod"
Introduce el valor correcto (755 para carpetas, 644 para archivos)
Aplica los cambios de forma recursiva si es necesario

[INFO] Los permisos 755 significan que el propietario puede leer, escribir y ejecutar; y el grupo y otros pueden leer y ejecutar. Los permisos 644 significan que el propietario puede leer y escribir, y el grupo y otros solo pueden leer.

Paso 6: Limpiar la caché de PrestaShop

A veces, la página en blanco en PrestaShop se debe a una caché corrupta. Los archivos de caché guardan versiones compiladas de las plantillas y configuraciones, y si se corrompen, pueden causar errores.

Limpiar caché manualmente

Accede a tu hosting por FTP o administrador de archivos
Navega hasta la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores)
Elimina todos los archivos y carpetas dentro de la carpeta de caché
No elimines la carpeta en sí, solo su contenido
Recarga tu tienda

[TIP] También puedes limpiar la caché desde el panel de administración si puedes acceder: Parámetros avanzados > Rendimiento > Vaciar la caché.

Paso 7: Verificar el archivo settings.inc.php o parameters.php

Estos archivos contienen la configuración de conexión a la base de datos y otras opciones críticas. Si están corruptos o incompletos, PrestaShop no puede iniciarse y muestra una pantalla blanca.

Cómo comprobar estos archivos

Para PrestaShop 1.7 y superiores:

Navega hasta app/config/parameters.php
Ábrelo con un editor de texto
Verifica que contiene los datos de conexión a tu base de datos MySQL
Comprueba que el nombre de la base de datos, usuario y contraseña son correctos

Para PrestaShop 1.6 y anteriores:

Navega hasta config/settings.inc.php
Ábrelo y verifica los mismos datos de conexión

[WARNING] Si no estás seguro de si los datos son correctos, contacta con tu proveedor de hosting. No cambies estos datos a menos que sepas exactamente lo que estás haciendo.

Paso 8: Actualizar la versión de PHP

PrestaShop requiere una versión específica de PHP para funcionar correctamente. Si tu hosting utiliza una versión demasiado antigua o demasiado nueva, puedes experimentar el white screen prestashop.

Versiones recomendadas de PHP

PrestaShop 1.6: PHP 5.6 a 7.1
PrestaShop 1.7: PHP 7.1 a 7.4 (idealmente 7.4)
PrestaShop 8: PHP 7.2 a 8.1

Cómo cambiar la versión de PHP desde Syspanel (puerto 2106)

Accede a Syspanel (tu-dominio.com:2106)
Busca la sección "PHP" o "Versión de PHP"
Selecciona la versión recomendada para tu PrestaShop
Guarda los cambios

[INFO] Si cambias la versión de PHP, asegúrate de que todos tus módulos sean compatibles con esa versión. Algunos módulos antiguos pueden dejar de funcionar.

Paso 9: Restaurar desde una copia de seguridad

Si has probado todos los pasos anteriores y la página en blanco prestashop persiste, puede que necesites restaurar tu tienda desde una copia de seguridad anterior.

¿Qué debes restaurar?

Los archivos de PrestaShop (excepto la carpeta img si quieres mantener tus imágenes)
La base de datos

Restaurar desde Syspanel (puerto 2106)

Accede a Syspanel
Busca la sección "Copias de seguridad" o "Backups"
Selecciona la copia de seguridad más reciente que sea anterior al problema
Restaura tanto los archivos como la base de datos
Espera a que termine el proceso y recarga tu tienda

[WARNING] Restaurar una copia de seguridad eliminará todos los cambios realizados desde esa copia. Asegúrate de tener una copia actual de tus datos antes de proceder.

Paso 10: Contactar con soporte especializado

Si después de todos estos pasos el error pantalla blanca prestashop continúa, puede que el problema sea más complejo de lo que parece. En ese caso, es recomendable buscar ayuda profesional.

Cuándo contactar con soporte

Si el error apareció después de una actualización de PrestaShop
Si no puedes acceder ni al front office ni al back office
Si has modificado archivos del núcleo de PrestaShop
Si sospechas que tu sitio ha sido hackeado

Información que debes proporcionar

La versión exacta de PrestaShop
La versión de PHP de tu servidor
El mensaje de error exacto (si lo has podido ver tras activar el modo depuración)
Los últimos cambios que realizaste antes de que apareciera el problema

Preguntas frecuentes (FAQ)

¿La página en blanco en PrestaShop significa que he perdido mis datos?

No. La página en blanco prestashop es un error de visualización, no un error de datos. Tus productos, pedidos y clientes siguen en la base de datos. Lo que ocurre es que PrestaShop no puede renderizar la página correctamente.

¿Puedo prevenir el white screen en el futuro?

Sí, siguiendo estas buenas prácticas:

Realiza copias de seguridad periódicas
Actualiza PrestaShop y los módulos en entornos de prueba antes de aplicarlos en producción
Mantén un registro de los cambios que realizas
No instales módulos de fuentes no oficiales
Aumenta el límite de memoria PHP de forma proactiva

¿Cuánto tiempo se tarda en arreglar este problema?

Depende de la causa. Los problemas de caché o memoria suelen solucionarse en minutos. Los problemas con módulos o temas pueden llevar una hora. Si necesitas restaurar una copia de seguridad, puede tardar entre 30 minutos y varias horas.

¿Necesito conocimientos técnicos para solucionarlo?

No necesariamente. Siguiendo esta guía paso a paso, la mayoría de usuarios pueden resolver el problema sin ayuda técnica. Sin embargo, si no te sientes cómodo modificando archivos, siempre puedes contactar con un profesional.

Conclusión

La página en blanco en PrestaShop o white screen prestashop es un problema frustrante pero solucionable. En la mayoría de los casos, se debe a:

Límite de memoria PHP insuficiente
Módulos o temas incompatibles
Caché corrupta
Permisos incorrectos

Siguiendo los pasos de esta guía, podrás identificar la causa y solucionar el error pantalla blanca prestashop sin necesidad de ser un experto técnico.

Recuerda que la clave está en activar el modo de depuración primero para ver el error real, y luego ir descartando causas una a una. Y si todo falla, no dudes en contactar con tu proveedor de hosting o un especialista en PrestaShop.

[TIP] Guarda esta guía en un lugar accesible. Si el problema vuelve a aparecer, podrás seguir los pasos rápidamente y minimizar el tiempo de inactividad de tu tienda.