Cómo resolver el error 'PrestaShop no carga o muestra pantalla en blanco'

¿Te ha pasado que entras a tu tienda PrestaShop y, en lugar de ver tus productos, te encuentras con una pantalla en blanco? No te preocupes, no eres el único. Este es uno de los errores típicos de PrestaShop y, aunque parezca grave, en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo.

En esta guía completa, paso a paso, vamos a desglosar las causas más comunes de la pantalla blanca en PrestaShop y te enseñaré a solucionar PrestaShop blanco incluso si no eres un experto en programación. Respira hondo, coge un café y vamos a ello.

¿Por qué ocurre el error "PrestaShop no carga"?

La temida pantalla blanca (también conocida como "White Screen of Death" o WSOD) es un síntoma genérico. Significa que PHP, el lenguaje en el que está escrito PrestaShop, está fallando silenciosamente. No te muestra un mensaje de error bonito, simplemente se rinde y no genera nada de HTML para el navegador.

Las razones suelen agruparse en tres grandes bloques:

1. Límite de memoria de PHP agotado: Es la causa más frecuente. Tu tienda necesita más memoria de la que el servidor le permite usar.
2. Errores de código o módulos incompatibles: Una actualización fallida, un módulo mal configurado o un tema con errores pueden romper la tienda.
3. Problemas de permisos o archivos corruptos: Durante una instalación o actualización, algunos archivos pueden dañarse o perder los permisos de lectura necesarios.

Vamos a atacar cada uno de estos puntos por orden, de lo más fácil a lo más complejo.

Primeros auxilios: Activa el modo depuración (la clave para todo)

Antes de tocar nada, necesitamos que PrestaShop nos diga qué le pasa. Por defecto, oculta los errores para que los clientes no vean mensajes raros. Nosotros vamos a activar el modo depuración para que los errores se muestren en pantalla.

No te asustes, solo es editar un archivo de configuración. Para ello, necesitas acceder a tu hosting (cPanel, Plesk o el panel que uses). Si usas Syspanel, recuerda que el acceso es a través del puerto 2106.

Paso 1: Localiza el archivo config/defines.inc.php

Conéctate a tu servidor mediante el administrador de archivos de tu hosting o por FTP (con programas como FileZilla). Busca la carpeta raíz donde está instalada tu tienda (normalmente public_html o www). Dentro de ella, entra en la carpeta config y busca el archivo llamado defines.inc.php.

Paso 2: Edita la línea de depuración

Haz clic derecho sobre el archivo y selecciona "Editar" o "Edit". Busca la siguiente línea:

define('_PS_MODE_DEV_', false);

Debes cambiarla por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y sustitúyelo en el servidor si lo estabas editando localmente.

[TIP] Este cambio es como encender la luz en una habitación oscura. Ahora, en lugar de una pantalla blanca, verás un mensaje de error en rojo, amarillo o naranja que nos dirá exactamente qué archivo y qué línea está fallando. Anota ese mensaje, es oro puro.

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

Si el mensaje de error menciona "Allowed memory size of X bytes exhausted", entonces este es tu problema. El remedio es sencillo: darle más memoria a PHP.

Opción A: Desde el panel de control de tu hosting

La mayoría de los paneles (cPanel, Plesk, Syspanel) tienen una sección llamada "Select PHP Version" o "MultiPHP INI Editor".

1. Busca esa sección.
2. Aumenta el valor de memory_limit. Empieza con 256M o 512M.
3. Guarda los cambios.

Opción B: Editando el archivo .htaccess

Si no encuentras la opción en el panel, puedes añadir una línea en el archivo .htaccess, que está en la raíz de tu instalación.

1. Edita el archivo .htaccess.
2. Al principio del archivo, añade esta línea:

php_value memory_limit 512M

3. Guarda y sube el archivo.

Opción C: Creando un archivo php.ini

Si las opciones anteriores no funcionan, crea un archivo llamado php.ini en la raíz de tu PrestaShop y añade dentro:

memory_limit = 512M

[WARNING] Después de hacer cualquiera de estos cambios, vuelve a cargar tu tienda. Si el problema era la memoria, la pantalla blanca debería desaparecer. Si no es así, sigue leyendo.

Solución 2: Revisar y desactivar módulos o temas problemáticos

Los módulos son la causa de muchos quebraderos de cabeza. A veces, uno recién instalado o actualizado es incompatible con tu versión de PrestaShop y provoca un fallo fatal.

Paso 1: Renombra la carpeta de módulos

Esta es una forma rápida de desactivar todos los módulos a la vez.

1. Ve a la carpeta raíz de tu PrestaShop y busca la carpeta llamada modules.
2. Cámbiale el nombre, por ejemplo, a modules_old.
3. Crea una nueva carpeta vacía llamada modules.

Vuelve a cargar tu tienda. Si ahora carga correctamente, el problema era uno de los módulos.

[WARNING] No dejes la tienda así. Ahora tendrás que ir moviendo los módulos de uno en uno desde modules_old a la nueva carpeta modules (empezando por los más importantes, como los de pago y envío) y comprobar que la tienda sigue funcionando. Cuando deje de funcionar, habrás encontrado al culpable. Después, elimina o actualiza ese módulo.

Paso 2: Cambia el tema a uno por defecto

Si los módulos no eran el problema, puede ser el tema.

1. Ve a la carpeta themes en la raíz de tu instalación.
2. Verás una carpeta con el nombre de tu tema (ej. classic, warehouse, etc.).
3. Cámbiale el nombre a tema_roto.
4. Si tienes el tema por defecto (classic), renómbralo a classic_bak.
5. Ahora, ve a la carpeta config y busca el archivo settings.inc.php. Ábrelo y busca una línea que diga define('_PS_THEME_NAME_', 'tu_tema');. Cámbiala por define('_PS_THEME_NAME_', 'classic'); y guarda.

Esto forzará a PrestaShop a usar el tema clásico. Si la tienda carga, el problema era de tu tema.

Solución 3: Comprobar los permisos de los archivos

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos necesarios.

1. Selecciona todos los archivos y carpetas de tu instalación de PrestaShop en el administrador de archivos.
2. Haz clic en "Permisos" o "Permissions".
3. Establece los permisos a 755 para las carpetas y 644 para los archivos.
4. Aplica los cambios.

[INFO] Si no sabes cómo hacer esto, la mayoría de los paneles de control tienen un botón para "restablecer permisos" o puedes hacerlo fácilmente con un cliente FTP como FileZilla seleccionando todo y cambiando los permisos en bloque.

Solución 4: Revisar el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado puede provocar un error 500 (que se manifiesta como pantalla blanca a veces).

Regenerar el archivo .htaccess

1. Ve a la raíz de tu instalación.
2. Renombra el archivo .htaccess a .htaccess_old.
3. Ahora ve al panel de administración de tu tienda (/admin). Si no puedes acceder, no te preocupes.
4. En el back office, ve a Parámetros Avanzados > Rendimiento y pulsa el botón "Guardar" en la parte inferior. Esto regenerará el archivo .htaccess.

Si no puedes acceder al back office, crea un archivo .htaccess vacío y súbelo a la raíz. PrestaShop lo regenerará la próxima vez que se cargue una página.

Solución 5: Limpiar la caché de Smarty

La caché de PrestaShop puede estar corrupta. Limpiarla es un remedio muy efectivo.

Si tienes acceso al back office:

Ve a Parámetros Avanzados > Rendimiento y haz clic en el botón "Vaciar la caché" en la parte superior.

Si no tienes acceso:

1. Conéctate por FTP o al administrador de archivos.
2. Ve a la carpeta var/cache (en versiones antiguas era cache).
3. Dentro de cache, busca una carpeta llamada prod (para producción). Dentro de ella, hay una carpeta cache.
4. Borra todos los archivos que estén dentro de la carpeta cache. No borres la carpeta en sí, solo su contenido.

[TIP] Es como limpiar la memoria del móvil. A veces, un archivo en caché se corrompe y da problemas. Al borrarlo, PrestaShop lo regenerará desde cero.

Solución 6: Reinstalar los archivos del núcleo (Core)

Si nada de lo anterior funciona, es probable que tengas archivos corruptos del propio PrestaShop.

1. Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial o el marketplace de tu hosting.
2. Descomprime el archivo en tu ordenador.
3. Sube solo la carpeta admin (y renómbrala con el nombre de tu carpeta admin actual) a tu servidor, sobrescribiendo la existente. Esto no toca tus datos.
4. Si el problema persiste, sube también el resto de carpetas del núcleo (classes, controllers, src, etc.) excepto las carpetas config, img, modules, themes y var. Sobrescribe los archivos existentes.

[WARNING] Este proceso es seguro para tus productos y pedidos, ya que no toca la base de datos. Solo reemplaza los archivos del programa.

Preguntas Frecuentes (FAQ) sobre la pantalla blanca en PrestaShop

¿El error de pantalla blanca puede dañar mis datos?

No. La pantalla blanca es un fallo de visualización. Tus productos, clientes y pedidos están a salvo en la base de datos. El problema es que no puedes verlos. Siguiendo estos pasos, recuperarás el acceso sin perder información.

¿Qué hago si veo un mensaje de error "500 Internal Server Error"?

Un error 500 es primo hermano de la pantalla blanca. Las soluciones son las mismas: aumenta el límite de memoria, comprueba los permisos de los archivos y revisa el .htaccess.

¿Puedo evitar que esto vuelva a pasar?

Sí. Mantén siempre tu PrestaShop, tus módulos y tu tema actualizados. Antes de instalar cualquier módulo o tema nuevo, haz una copia de seguridad de tu tienda y de tu base de datos. Esto es un seguro de vida para tu negocio online.

¿Necesito ser un programador para arreglar esto?

No. Las soluciones que te he dado son administrativas y no requieren conocimientos de código. Solo necesitas seguir los pasos con calma y paciencia. Si te pierdes, tu proveedor de hosting puede ayudarte, ya que tienen acceso al servidor.

Mi hosting usa Syspanel, ¿cómo accedo para hacer estos cambios?

Si tu hosting utiliza Syspanel, simplemente accede a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Una vez dentro, encontrarás el administrador de archivos y las opciones de PHP en el menú lateral, igual que en otros paneles.

[INFO] Recuerda que, si después de probar todas estas soluciones la pantalla blanca en PrestaShop persiste, el problema puede ser más profundo, como un conflicto con el servidor o un archivo .htaccess muy complejo. En ese caso, no dudes en contactar con el soporte técnico de tu hosting, proporcionándoles el mensaje de error exacto que obtuviste al activar el modo depuración. Ellos podrán revisar los logs del servidor para encontrar la causa raíz.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Ve paso a paso y, sobre todo, no te olvides de hacer copias de seguridad periódicas. ¡Tu tienda volverá a estar operativa en poco tiempo!