PrestaShop no carga | Solución errores hosting

Si tu tienda PrestaShop se ha quedado congelada, muestra una pantalla en blanco o simplemente no carga, no te preocupes. Es uno de los problemas más frecuentes en el mundo del comercio electrónico y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

En esta guía extensa y detallada, vamos a recorrer los errores de hosting más comunes que afectan a PrestaShop, y te daremos una solución paso a paso para cada uno. Hablaremos de la caché, los permisos de archivos, la configuración del servidor y otros factores clave. Al final, tendrás un checklist claro para diagnosticar y arreglar tu tienda.

1. Primeros pasos: ¿Qué está pasando exactamente?

Antes de lanzarte a modificar archivos, es importante identificar el tipo de error. Pregúntate:

¿La página carga pero muy lenta?
¿Aparece un mensaje de error específico (como "Error 500" o "Error de conexión a la base de datos")?
¿La pantalla está completamente en blanco (pantalla blanca de la muerte)?
¿Solo falla el panel de administración o también la tienda pública?

Anota lo que ves. Esto te ayudará a elegir la sección correcta de esta guía.

2. El enemigo silencioso: La caché de PrestaShop

Uno de los motivos más frecuentes por los que PrestaShop no carga es una caché corrupta o mal configurada. La caché guarda versiones temporales de tus páginas para que carguen más rápido, pero si se desactualiza o se daña, provoca errores.

### Cómo limpiar la caché manualmente (sin acceso al panel)

Si no puedes entrar al back office, hazlo desde el servidor:

Accede a tu panel de control de hosting (por ejemplo, cPanel, Plesk o Syspanel —recuerda que el puerto de acceso es el 2106—).
Ve al administrador de archivos o usa FTP.
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Elimina todo el contenido de la carpeta /var/cache/ (no borres la carpeta en sí, solo los archivos de dentro).
También borra la carpeta /cache/smarty/compile/ y /cache/smarty/cache/.

[TIP] Si no ves archivos, activa la opción "Mostrar archivos ocultos" en tu cliente FTP.

### Cómo desactivar la caché desde el back office (si aún puedes acceder)

Ve a Parámetros Avanzados > Rendimiento.
En la sección "Caché", selecciona "No usar caché".
En "Caché de plantillas", elige "Forzar compilación" y "No usar caché".
Guarda los cambios y vuelve a cargar tu tienda.

[WARNING] La desactivación de la caché ralentizará temporalmente tu tienda. Es solo para diagnóstico. Una vez todo funcione, vuelve a activarla.

3. Permisos de archivos: La causa oculta del 80% de los errores

Los permisos de archivos determinan quién puede leer, escribir o ejecutar los archivos de tu PrestaShop. Si están mal configurados, el sistema no puede guardar configuraciones, subir imágenes o incluso mostrar la página.

### Permisos correctos para PrestaShop

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivos de configuración (como config/settings.inc.php): 644 o 640 (nunca 777)

### Cómo corregir permisos desde Syspanel (HestiaCP)

Inicia sesión en Syspanel (puerto 2106).
Ve a Archivos > Administrador de archivos.
Selecciona la carpeta raíz de tu tienda.
Haz clic derecho y elige "Cambiar permisos".
Marca las opciones correctas (lectura, escritura, ejecución para el propietario; solo lectura para grupo y otros).
Repite para los archivos individuales.

[INFO] Si usas FTP, muchos clientes (como FileZilla) permiten cambiar permisos en masa seleccionando varias carpetas.

### El caso especial de la carpeta /img/ y /upload/

Estas carpetas necesitan permisos 755 para que puedas subir imágenes de productos. Si ves que las imágenes no se cargan, revisa esto primero.

4. Errores de hosting: Cuando el problema está en el servidor

A veces el fallo no es de PrestaShop, sino del entorno donde está alojado. Estos son los errores de hosting más comunes y cómo solucionarlos.

### Error 500 – Internal Server Error

Este error genérico suele deberse a:

Archivo .htaccess corrupto.
Módulo de PHP incompatible.
Límite de memoria excedido.

Solución rápida:

Renombra el archivo .htaccess a .htaccess_old (esto lo desactiva).
Si la tienda carga, regenera el .htaccess desde el back office: Parámetros Avanzados > SEO y URLs > Guardar.
Si no funciona, aumenta el límite de memoria en el archivo config/defines.inc.php:
- Busca la línea: define('_PS_MEMORY_LIMIT_', '128M');
- Cámbiala a 256M o 512M.

### Error de conexión a la base de datos

Suele aparecer como "Link to database cannot be established". Causas:

Contraseña de la base de datos cambiada.
Servidor MySQL caído.
Archivo config/settings.inc.php con datos incorrectos.

Solución:

Ve a tu panel de hosting y revisa que la base de datos esté activa.
Abre el archivo config/settings.inc.php y verifica que los datos de conexión (nombre, usuario, contraseña, servidor) sean correctos.
Si todo está bien, prueba a reparar la base de datos desde phpMyAdmin (selecciona todas las tablas y elige "Reparar").

[WARNING] Nunca compartas tu contraseña de base de datos en foros públicos.

5. Pantalla blanca (White Screen of Death)

Este es el error más temido. Sin mensaje, sin pista. Generalmente se debe a:

Un módulo recién instalado que da error.
Un archivo PHP con sintaxis incorrecta.
Falta de memoria.

### Cómo diagnosticar la pantalla blanca

Activa el modo debug: Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ a true. Esto mostrará el error real.
Desactiva módulos sospechosos: Renombra la carpeta /modules/nombre_del_modulo a /modules/nombre_del_modulo_old. Si la tienda vuelve a cargar, ese módulo es el culpable.
Revisa el log de errores del servidor: En Syspanel, ve a Herramientas > Logs del sistema y busca errores recientes relacionados con PHP.

[TIP] Si no puedes editar archivos, pide a tu hosting que active el modo debug por ti.

6. Problemas con el tema o plantilla

Un tema mal diseñado o incompatible con tu versión de PrestaShop puede impedir que la tienda cargue.

### Pasos para verificar el tema

Cambia temporalmente al tema predeterminado (por ejemplo, "Classic").
Si la tienda carga, el problema es tu tema personalizado.
Actualiza el tema a la última versión compatible con tu PrestaShop.
Si no hay actualización, contacta al desarrollador.

[INFO] Siempre prueba los temas en un entorno de desarrollo antes de instalarlos en producción.

7. Cómo evitar futuros errores (mantenimiento preventivo)

Una vez que tu tienda vuelva a funcionar, aplica estas buenas prácticas:

Actualiza PrestaShop regularmente: Las versiones nuevas corrigen bugs de seguridad y rendimiento.
Haz copias de seguridad semanales: Tanto de archivos como de la base de datos. Usa la herramienta de copias de Syspanel (puerto 2106) o un plugin.
Monitorea el espacio en disco: Si el disco se llena, PrestaShop dejará de funcionar.
Usa un CDN: Para aliviar la carga del servidor y evitar caídas por tráfico masivo.
Revisa los logs mensualmente: Los logs de error te avisarán de problemas antes de que se vuelvan críticos.

8. FAQ: Preguntas frecuentes sobre errores en PrestaShop

### ¿Por qué mi PrestaShop carga muy lento?

Las causas más comunes son: caché desactivada, módulos pesados, imágenes sin optimizar o un hosting compartido con recursos limitados. Prueba a activar la caché de Smarty y a comprimir imágenes con herramientas como TinyPNG.

### ¿Cómo puedo saber si el error es del hosting o de PrestaShop?

Crea un archivo info.php con el contenido <?php phpinfo(); ?> y súbelo a la raíz. Si se ve correctamente, el servidor funciona. Si no, el problema es de hosting.

### ¿Qué hago si no tengo acceso al back office?

Usa FTP o el administrador de archivos de tu panel de control para hacer los cambios manualmente. Si no tienes FTP, pide a tu proveedor de hosting que te lo active.

### ¿Es seguro borrar la carpeta /cache/?

Sí, es completamente seguro. PrestaShop la regenerará automáticamente. Eso sí, no borres la carpeta en sí, solo su contenido.

### ¿Cada cuánto debo limpiar la caché?

Después de cada actualización de módulos, tema o cambios importantes en la configuración. En operación normal, una vez al mes es suficiente.

Conclusión: Recupera tu tienda paso a paso

Cuando PrestaShop no carga, el pánico es normal, pero la mayoría de los casos se resuelven con estos pasos básicos: limpiar la caché, corregir permisos de archivos, revisar el .htaccess y aumentar la memoria. Si el error persiste, no dudes en contactar al soporte de tu hosting, pero asegúrate de haber probado antes todo lo que te hemos contado.

Recuerda que la clave está en la paciencia y en seguir un orden lógico. No modifiques todo a la vez; haz un cambio, prueba, y pasa al siguiente. Con esta guía, tu tienda volverá a estar operativa en pocos minutos.

[TIP FINAL] Guarda esta guía en tus favoritos. La próxima vez que tu tienda se congele, sabrás exactamente qué hacer.