Cómo arreglar el error 'PrestaShop no carga, página en blanco'

¿Por qué mi PrestaShop muestra una página en blanco?

Ver una página en blanco en tu tienda PrestaShop es una de las experiencias más frustrantes para cualquier propietario de un negocio online. Un momento tienes tu tienda funcionando y al siguiente, solo ves un fondo blanco sin ningún mensaje de error. Este problema, conocido técnicamente como "pantalla blanca de la muerte" (WSOD), afecta tanto a la tienda visible para tus clientes como al panel de administración.

La buena noticia es que, en la mayoría de los casos, este error tiene una solución clara y paso a paso que puedes aplicar tú mismo sin necesidad de ser un experto en programación. En esta guía extensa, te explicaré las causas más comunes del error PrestaShop no carga y te daré soluciones prácticas para solucionar PrestaShop blanco, incluso si nunca has tocado un archivo de código en tu vida.

Lo primero que debes entender es que la página en blanco PrestaShop es un mecanismo de protección. Cuando algo falla en el sistema, PrestaShop intenta mostrar un error, pero si la configuración de errores está desactivada (que es lo habitual en producción), simplemente muestra una página vacía para no exponer información sensible a los visitantes. Por tanto, nuestro objetivo será activar la visualización de errores para identificar el problema, o bien ir probando las soluciones más comunes directamente.

Activar el modo de depuración para ver el error real

Accede a tu servidor mediante FTP o el administrador de archivos

Para solucionar PrestaShop blanco, el primer paso es descubrir qué está fallando exactamente. PrestaShop tiene un modo de depuración (debug mode) que, cuando se activa, muestra en pantalla el error específico en lugar de la página en blanco.

Para activarlo, necesitas acceder a los archivos de tu instalación. Tienes dos opciones: usar un cliente FTP como FileZilla, o acceder al administrador de archivos de tu panel de hosting. Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), recuerda que el acceso se realiza a través del puerto 2106 y desde ahí puedes usar el administrador de archivos integrado.

Una vez dentro, busca el archivo llamado config/defines.inc.php en la raíz de tu instalación de PrestaShop. Ábrelo con un editor de texto (no con un procesador de textos) y busca la línea que dice:

define('_PS_MODE_DEV_', false);

Cambia false por true y guarda el archivo. Ahora, recarga tu tienda en el navegador. En lugar de la página en blanco, verás un mensaje de error detallado con la causa exacta del problema.

[!TIP]
Anota el mensaje de error que aparece. Te servirá para buscar soluciones específicas o para proporcionárselo a tu soporte técnico si lo necesitas.

[!WARNING]
Nunca dejes el modo de depuración activado en una tienda en producción. Una vez resuelto el problema, vuelve a cambiar true por false.

Comprobar los permisos de archivos y carpetas

La causa más común del error PrestaShop no carga

Si al activar el modo de depuración no ves ningún error, o si el error menciona problemas de permisos, es muy probable que el origen del problema sea una configuración incorrecta de permisos en tus archivos y carpetas.

PrestaShop necesita escribir en ciertos directorios para funcionar correctamente: caché, logs, archivos temporales, etc. Si estos directorios no tienen los permisos adecuados, la tienda no puede operar y muestra la página en blanco PrestaShop.

Para solucionarlo, accede nuevamente a tu servidor (FTP o administrador de archivos de Syspanel en el puerto 2106) y selecciona todos los archivos y carpetas de tu instalación de PrestaShop. En la mayoría de los clientes FTP, puedes hacer clic derecho y seleccionar "Permisos de archivo" o "CHMOD".

Los permisos correctos para PrestaShop son:

• Archivos: 644
• Carpetas: 755
• La carpeta config y cache: 755 (o incluso 777 temporalmente si el problema persiste)

[!INFO]
Si tu hosting es compartido, los permisos 644 y 755 son los estándar. Los permisos 777 son más permisivos y solo deben usarse temporalmente para pruebas, ya que pueden suponer un riesgo de seguridad.

Después de cambiar los permisos, recarga tu tienda. Si el problema era este, la página en blanco PrestaShop habrá desaparecido.

Limpiar la caché de PrestaShop

Una solución rápida para solucionar PrestaShop blanco

PrestaShop almacena mucha información en caché para cargar las páginas más rápido. Sin embargo, a veces esta caché se corrompe o contiene datos obsoletos que provocan conflictos y errores, incluyendo la página en blanco.

Para limpiar la caché sin acceder al panel de administración (que puede estar también en blanco), necesitas borrar manualmente los archivos de caché del servidor.

Accede a tu servidor y localiza la carpeta var/cache (en versiones antiguas de PrestaShop era cache). Dentro de esta carpeta encontrarás subcarpetas con nombres como dev, prod, cache_*. Borra todo el contenido de estas carpetas, pero no las carpetas en sí.

[!WARNING]
Asegúrate de no borrar la carpeta var/cache completa, solo su contenido. Si borras la carpeta, PrestaShop la recreará automáticamente al cargar, pero es mejor no arriesgarse.

También puedes intentar desactivar la caché desde el archivo config/defines.inc.php que ya hemos visto. Busca la línea:

define('_PS_CACHE_ENABLED_', '0');

Si está en '1', cámbiala a '0' para desactivar la caché temporalmente. Esto te permitirá ver si el problema está relacionado con la caché.

Verificar la versión de PHP y los requisitos del sistema

Un error PrestaShop no carga muy común en actualizaciones

PrestaShop es una plataforma exigente en cuanto a los requisitos del servidor. Si has actualizado PrestaShop recientemente, o si tu proveedor de hosting ha cambiado la versión de PHP, es muy probable que te encuentres con una página en blanco.

Cada versión de PrestaShop requiere una versión específica de PHP. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.1 o superior, pero no con PHP 8.1 en algunas versiones antiguas. Si tu versión de PHP no es compatible, la tienda no cargará.

Para comprobar tu versión de PHP, accede a tu panel de control. Si usas Syspanel, recuerda que el acceso es por el puerto 2106. Busca la sección de "PHP" o "Versión de PHP" y verifica cuál tienes configurada.

Si no estás seguro de qué versión necesitas, consulta los requisitos de tu versión concreta de PrestaShop en la documentación oficial. Como regla general:

• PrestaShop 1.6: PHP 5.4 a 7.1
• PrestaShop 1.7.0 a 1.7.7: PHP 5.6 a 7.3
• PrestaShop 1.7.8 y 8.x: PHP 7.2 a 8.1

Para cambiar la versión de PHP, en la mayoría de los paneles de control basta con seleccionar la versión deseada en un menú desplegable y guardar los cambios. Después, recarga tu tienda.

[!TIP]
Si tu tienda funcionaba bien y de repente muestra la página en blanco, revisa si tu hosting ha realizado algún cambio en la configuración del servidor. A veces las actualizaciones automáticas de PHP provocan incompatibilidades.

Revisar los módulos y temas instalados

Un conflicto entre módulos puede causar el error PrestaShop no carga

Los módulos y temas son extensiones que añaden funcionalidades a tu tienda, pero también son una de las causas más frecuentes de la página en blanco PrestaShop. Un módulo mal codificado, incompatible con tu versión, o que entra en conflicto con otro módulo, puede romper toda la tienda.

Si el problema comenzó después de instalar o actualizar un módulo o tema, ese es casi seguro el culpable. Para solucionarlo, necesitas desactivar el módulo o tema problemático. El problema es que si tu panel de administración también está en blanco, no puedes hacerlo desde la interfaz.

La solución es desactivar el módulo manualmente desde la base de datos. Para ello, necesitas acceder a phpMyAdmin (disponible en Syspanel, puerto 2106). Una vez dentro, selecciona la base de datos de tu PrestaShop y busca la tabla ps_module (el prefijo puede variar si lo cambiaste durante la instalación).

Busca el módulo sospechoso en la lista y cambia su estado de 1 (activo) a 0 (inactivo). También puedes probar a desactivar todos los módulos no esenciales de una vez para ver si la tienda vuelve a cargar.

Para desactivar un tema, busca la tabla ps_theme y cambia el tema activo por el tema predeterminado de PrestaShop.

[!WARNING]
Antes de modificar la base de datos, realiza una copia de seguridad. Un error en la base de datos puede provocar problemas mayores que la página en blanco.

Incrementar el límite de memoria PHP

Solucionar PrestaShop blanco por falta de memoria

PrestaShop es una aplicación que consume bastante memoria, especialmente si tienes muchos módulos activos o un catálogo grande. Si el límite de memoria PHP es demasiado bajo, la tienda puede mostrar una página en blanco sin ningún mensaje de error.

Para aumentar el límite de memoria, tienes varias opciones. La más sencilla es editar el archivo config/defines.inc.php y añadir la siguiente línea al principio del archivo:

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

También puedes intentar modificar el archivo .htaccess en la raíz de tu instalación. Añade esta línea:

php_value memory_limit 512M

Si ninguna de estas opciones funciona, contacta con tu proveedor de hosting para que aumente el límite de memoria desde la configuración del servidor.

[!INFO]
Un límite de memoria de 256M suele ser suficiente para la mayoría de tiendas. Si necesitas más, es recomendable optimizar tu tienda en lugar de aumentar la memoria indefinidamente.

Comprobar los archivos de configuración de la base de datos

El archivo parameters.php puede estar dañado

Otro archivo crítico que puede provocar el error PrestaShop no carga es app/config/parameters.php. Este archivo contiene los datos de conexión a tu base de datos. Si está dañado, mal configurado o ha sido modificado accidentalmente, PrestaShop no puede conectarse a la base de datos y muestra una página en blanco.

Abre este archivo con un editor de texto y verifica que los datos sean correctos:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Comprueba que estos valores coinciden con los de tu base de datos. Si no estás seguro, puedes encontrarlos en el panel de control de tu hosting (recuerda, Syspanel en el puerto 2106).

[!TIP]
Si has cambiado recientemente la contraseña de tu base de datos, asegúrate de actualizarla también en este archivo.

Verificar el archivo .htaccess

Un .htaccess corrupto puede causar la página en blanco PrestaShop

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor web. PrestaShop lo utiliza para las URLs amigables, redirecciones y otras funciones. Si este archivo está corrupto o tiene directivas incompatibles, puede provocar el error PrestaShop no carga.

Para comprobarlo, accede a la raíz de tu instalación y busca el archivo .htaccess. Si no lo ves, activa la opción de "mostrar archivos ocultos" en tu cliente FTP.

Puedes probar a renombrar el archivo a .htaccess.bak y recargar tu tienda. PrestaShop generará automáticamente un nuevo .htaccess si la tienda carga correctamente. Si el problema se resuelve, el archivo original estaba dañado.

[!WARNING]
Si renombras el .htaccess, perderás las URLs amigables temporalmente. No te preocupes, PrestaShop las regenerará automáticamente al reconstruir el archivo.

Restaurar una copia de seguridad

La solución definitiva si nada funciona

Si has probado todas las soluciones anteriores y la página en blanco PrestaShop persiste, es hora de considerar restaurar una copia de seguridad. Esta es la solución más drástica, pero también la más segura si tienes una copia reciente de tu tienda.

La mayoría de los servicios de hosting ofrecen copias de seguridad automáticas. Si usas Syspanel (puerto 2106), busca la sección de "Copias de seguridad" o "Backups". Desde ahí puedes restaurar tu tienda a un estado anterior en el que funcionaba correctamente.

Antes de restaurar, asegúrate de tener una copia de seguridad de la base de datos actual, por si necesitas recuperar pedidos o clientes posteriores a la copia que vas a restaurar.

[!INFO]
La restauración de una copia de seguridad debe ser tu último recurso, ya que perderás los cambios realizados desde la fecha de la copia. Pero es mejor perder algunos cambios que tener la tienda completamente inoperativa.

Preguntas frecuentes sobre la página en blanco en PrestaShop

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

Depende de la causa. Si es un problema de permisos o caché, puedes solucionarlo en menos de 15 minutos. Si es un conflicto de módulos o un problema de base de datos, puede llevarte una hora o más. Si tienes que restaurar una copia de seguridad, el tiempo dependerá del tamaño de tu tienda.

¿Necesito conocimientos técnicos para resolverlo?

No necesariamente. Las soluciones que te he explicado son accesibles para usuarios sin experiencia técnica. Solo necesitas saber usar un cliente FTP o el administrador de archivos de tu hosting, y seguir los pasos con atención.

¿Puedo evitar que esto vuelva a ocurrir?

Sí. Mantén tu PrestaShop actualizado, utiliza módulos de fuentes confiables, realiza copias de seguridad periódicas y no modifiques archivos sin saber lo que haces. También es recomendable probar los cambios en un entorno de prueba antes de aplicarlos en tu tienda en producción.

¿Debo contactar con mi proveedor de hosting?

Si has probado todas las soluciones y el problema persiste, sí. Es posible que el problema esté en el servidor y no en tu instalación de PrestaShop. Tu proveedor puede revisar los logs del servidor para identificar el error exacto.

La página en blanco PrestaShop puede parecer un problema grave, pero como has visto, tiene solución en la mayoría de los casos. Sigue estos pasos con calma, realiza una copia de seguridad antes de hacer cambios importantes y no dudes en pedir ayuda si la necesitas. Tu tienda volverá a estar operativa en poco tiempo.