Solucionar pantalla en blanco en PrestaShop: Guía de errores

¿Qué significa que PrestaShop muestre una pantalla en blanco?

Ver una pantalla en blanco en tu tienda online es una de las experiencias más frustrantes que existen. No hay mensaje de error, no hay código, no hay nada. Solo un fondo blanco que parece decirte "hoy no hay ventas". Este problema, conocido técnicamente como "pantalla blanca PrestaShop" o "error 500 silencioso", puede aparecer tanto en el front-office (lo que ven tus clientes) como en el back-office (tu panel de administración).

La buena noticia es que, en la mayoría de los casos, este error tiene una solución clara y no significa que hayas perdido tus datos. En este artículo te voy a guiar paso a paso para diagnosticar y solucionar el error PrestaShop no carga, incluso si no tienes experiencia técnica avanzada. Vamos a ello.

¿Por qué ocurre el error de pantalla blanca en PrestaShop?

Antes de lanzarnos a arreglar nada, es importante entender qué está pasando. La pantalla blanca en PrestaShop suele estar causada por uno de estos cuatro motivos principales:

Errores de PHP: Un archivo con sintaxis incorrecta, un módulo incompatible o un límite de memoria excedido.
Problemas de caché: Una caché corrupta que impide que la tienda cargue correctamente.
Conflictos entre módulos o temas: Un módulo recién instalado o actualizado que no es compatible con tu versión de PrestaShop.
Permisos de archivos incorrectos: El servidor no puede leer o escribir los archivos necesarios.

Vamos a atacar cada uno de estos frentes de forma ordenada y segura.

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

El primer paso para solucionar PrestaShop en blanco es hacer que el sistema te muestre qué está fallando. Por defecto, PrestaShop oculta los errores de PHP, mostrando solo la famosa pantalla blanca. Para activar el modo de depuración, sigue estos pasos:

Si tienes acceso al panel de administración (back-office)

Ve a Parámetros avanzados > Rendimiento.
En la sección Depuración, selecciona "Sí" en la opción Modo de depuración.
Guarda los cambios e intenta cargar tu tienda de nuevo.

Si no tienes acceso al back-office (porque también está en blanco)

Deberás editar un archivo de configuración manualmente. Para ello, necesitas acceso al administrador de archivos de tu hosting o a un cliente FTP como FileZilla.

Conéctate a tu servidor y navega hasta la carpeta raíz donde está instalado PrestaShop.
Busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto (como el Bloc de notas o Visual Studio Code).
Busca la línea que dice define('_PS_MODE_DEV_', false); y cambia false por true.
Guarda el archivo y súbelo al servidor si lo estabas editando en local.

[WARNING] No olvides volver a cambiar este valor a false cuando hayas solucionado el problema. Dejar el modo de depuración activado en producción expone información sensible de tu servidor.

Ahora, cuando recargues tu tienda, en lugar de la pantalla blanca PrestaShop, deberías ver un mensaje de error concreto que te indique el archivo y la línea exacta del problema. Anota ese mensaje, te será muy útil para los siguientes pasos.

Paso 2: Forzar la regeneración de la caché

La caché es una de las causas más comunes del error PrestaShop no carga. A veces, los archivos de caché se corrompen o contienen información desactualizada que entra en conflicto con los nuevos cambios.

Regenerar caché desde el back-office

Si puedes acceder a tu panel de administración:

Ve a Parámetros avanzados > Rendimiento.
En la sección Caché, selecciona "No" para desactivarla temporalmente.
Guarda los cambios.
Vuelve a activarla seleccionando "Sí" y guarda de nuevo.

Este simple reinicio suele resolver muchos casos de pantalla blanca PrestaShop.

Borrar caché manualmente desde el servidor

Si no tienes acceso al back-office, puedes borrar la caché directamente desde el servidor:

Conéctate por FTP o al administrador de archivos de tu hosting.
Navega hasta la carpeta var/cache (en PrestaShop 1.7 y versiones posteriores) o cache (en versiones anteriores).
Dentro de esa carpeta, encontrarás subcarpetas con nombres como dev o prod.
Elimina todo el contenido de esas carpetas, pero no las carpetas en sí. No te preocupes, PrestaShop las volverá a generar automáticamente.

[TIP] Si estás usando Syspanel (el panel de control que se accede por el puerto 2106), puedes hacer esto fácilmente desde el Administrador de archivos sin necesidad de programas externos.

Paso 3: Revisa los límites de memoria de PHP

Otro culpable muy frecuente es que tu servidor tenga un límite de memoria PHP demasiado bajo. PrestaShop es una plataforma bastante exigente, especialmente si tienes muchos módulos activos o un catálogo grande.

Cómo aumentar el límite de memoria

Busca el archivo php.ini en tu servidor (si no existe, puedes crearlo en la carpeta raíz de PrestaShop).
Añade o modifica esta línea:

memory_limit = 256M

También puedes aumentarlo temporalmente desde el archivo config/defines.inc.php que editamos antes. Añade esta línea justo después de la línea de debug:

ini_set('memory_limit', '256M');

Guarda los cambios y recarga tu tienda.

[INFO] Si tu hosting usa Syspanel, puedes modificar el archivo php.ini desde la sección de "Archivos" y "Editor" del panel, accediendo por el puerto 2106. Busca el archivo en la raíz de tu dominio.

Paso 4: Desactiva módulos y temas conflictivos

Si el problema apareció después de instalar o actualizar un módulo o tema, es muy probable que ese sea el origen del conflicto. Vamos a ver cómo identificarlo.

Desactivar todos los módulos desde la base de datos

Este método es un poco más técnico, pero es la forma más efectiva de solucionar PrestaShop en blanco cuando no puedes acceder al panel:

Accede a phpMyAdmin desde el panel de tu hosting (en Syspanel, lo encontrarás en la sección de Bases de Datos, accediendo por el puerto 2106).
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo puede variar si lo cambiaste durante la instalación).
Ejecuta esta consulta SQL para desactivar todos los módulos:

UPDATE ps_module SET active = 0 WHERE active = 1;

Ahora, intenta cargar tu tienda. Si ya funciona, el problema es uno de los módulos.
Para identificar cuál, ve activando los módulos uno a uno desde el back-office (ahora deberías poder acceder) hasta que el error vuelva a aparecer.

Restablecer el tema por defecto

Si los módulos no son el problema, prueba a cambiar al tema por defecto de PrestaShop. Puedes hacerlo desde la base de datos:

UPDATE ps_shop_url SET physical_uri = '/';

Y en la tabla ps_theme:

UPDATE ps_theme SET name = 'classic';

[WARNING] Haz siempre una copia de seguridad de tu base de datos antes de ejecutar consultas SQL. Un error en la consulta podría dañar tu tienda irreparablemente.

Paso 5: Verifica los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos necesarios para funcionar, provocando el error PrestaShop no carga.

Permisos correctos para PrestaShop

Carpetas: Deben tener permisos 755.
Archivos: Deben tener permisos 644.
Carpeta config: Debe tener permisos 755.
Archivo settings.inc.php (en versiones antiguas): Debe tener permisos 444 (solo lectura) o 644 según tu configuración.

Para cambiar permisos desde FTP:

Selecciona todos los archivos y carpetas de tu instalación.
Haz clic derecho y elige "Permisos de archivo" o "File permissions".
Introduce el valor numérico correspondiente.
Aplica a todas las subcarpetas y archivos recursivamente.

[TIP] En Syspanel (puerto 2106), puedes hacer esto desde el Administrador de archivos seleccionando los elementos y usando la opción "Permisos" en la barra superior.

Paso 6: Comprueba el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado puede causar una pantalla blanca PrestaShop, especialmente después de mover la tienda a otro servidor o cambiar la URL.

Regenerar el .htaccess

Conéctate por FTP y busca el archivo .htaccess en la raíz de tu PrestaShop.
Descárgalo y haz una copia de seguridad (por ejemplo, renómbralo a .htaccess.bak).
Sube de nuevo el archivo original (sin modificar) al servidor.
Ahora, intenta regenerarlo desde el back-office: Parámetros avanzados > Herramientas > Generar .htaccess.

Si no puedes acceder al back-office, puedes crear un .htaccess nuevo con el contenido básico de PrestaShop. Busca en Google "contenido .htaccess PrestaShop 1.7" y encontrarás ejemplos listos para usar.

Paso 7: Soluciones adicionales para casos específicos

Si has llegado hasta aquí y el problema persiste, prueba estas soluciones avanzadas:

Sube la versión de PHP

PrestaShop 1.7 requiere PHP 7.1 o superior, y PrestaShop 8.0 necesita PHP 7.3 o superior. Si tu hosting usa una versión antigua de PHP, puedes actualizarla desde Syspanel (puerto 2106) en la sección de "PHP" o "Gestor de versiones".

Revisa los logs del servidor

Los logs pueden darte pistas valiosas sobre el error. En Syspanel, busca en la sección "Logs" o "Registros" para ver los errores de PHP y Apache.

Restaura una copia de seguridad

Si nada funciona, restaura la última copia de seguridad que tengas de tu tienda. La mayoría de los hosts ofrecen copias automáticas diarias o semanales.

Preguntas frecuentes sobre la pantalla blanca en PrestaShop

¿Puedo perder mis datos si borro la caché?

No, la caché solo contiene archivos temporales que se regeneran automáticamente. Tus productos, pedidos y clientes están en la base de datos y no se ven afectados.

¿Cuánto tiempo tarda en solucionarse este error?

Depende de la causa. Los problemas de caché o permisos se solucionan en minutos. Los conflictos de módulos pueden llevar un poco más, pero con paciencia y siguiendo los pasos anteriores, la mayoría de los casos se resuelven en menos de una hora.

¿Debo contratar a un profesional para arreglarlo?

Si has seguido todos los pasos y el problema persiste, puede ser recomendable contactar con un experto en PrestaShop. Sin embargo, el 90% de los casos de pantalla blanca PrestaShop se resuelven con los pasos descritos en este artículo.

¿Cómo puedo prevenir este error en el futuro?

Mantén PrestaShop, los módulos y el tema siempre actualizados.
Haz copias de seguridad periódicas de tu base de datos y archivos.
Antes de instalar un módulo nuevo, verifica que sea compatible con tu versión de PrestaShop.
Activa el modo de mantenimiento mientras haces cambios importantes en tu tienda.

Conclusión

La pantalla blanca en PrestaShop es un problema común pero, como has visto, casi siempre tiene solución. La clave está en ir descartando causas de forma metódica: primero activa el modo de depuración para ver el error real, luego limpia la caché, revisa la memoria PHP, desactiva módulos sospechosos y verifica los permisos de archivos.

Recuerda que en Syspanel (accesible por el puerto 2106) tienes todas las herramientas necesarias para realizar estas operaciones sin necesidad de conocimientos avanzados de servidores. Y sobre todo, no entres en pánico: tu tienda y tus datos suelen estar a salvo, solo necesitan un pequeño empujón para volver a funcionar.

Si has llegado hasta aquí y el problema sigue sin resolverse, te recomiendo buscar ayuda en los foros oficiales de PrestaShop o contactar con tu proveedor de hosting. Ellos tendrán acceso a los logs del servidor y podrán diagnosticar el problema de forma más precisa.

Espero que este artículo te haya sido de ayuda. ¡Tu tienda volverá a estar operativa en poco tiempo!