Problemas de caché en PrestaShop | Solución con Syspanel

¿Tu tienda PrestaShop va lenta, muestra versiones antiguas de tus productos o directamente te aparece un error de caché en el panel de Syspanel? No te preocupes, es uno de los problemas más comunes al gestionar una tienda online. La caché es una aliada estupenda para la velocidad, pero cuando se corrompe o se queda obsoleta, puede convertirse en una pesadilla.

En esta guía extensa y paso a paso, vamos a desglosar cómo resolver el problema de la caché en PrestaShop para Syspanel. Voy a explicarte qué es exactamente, por qué falla, y sobre todo, te daré todos los métodos posibles para limpiarla y dejarla funcionando como nueva, incluso si no eres un experto técnico.

Vamos a ello. Respira hondo, porque al final de este artículo serás un pequeño ninja de la caché.

¿Qué es la caché de PrestaShop y por qué causa errores?

Antes de lanzarnos a limpiar, es fundamental entender qué estamos tocando. Imagina que la caché es como una despensa en tu cocina. Para no ir al supermercado (la base de datos) cada vez que quieres hacer una receta (mostrar una página web), guardas los ingredientes básicos en la despensa (caché). Así, cuando un cliente entra a tu tienda, el servidor no tiene que calcular todo desde cero, sino que sirve la versión "guardada" y va mucho más rápido.

El problema surge cuando la receta cambia (modificas un precio, un texto o una imagen) pero la despensa sigue teniendo los ingredientes viejos. El resultado es que tú ves el cambio en el administrador, pero tus clientes ven la versión antigua. A esto se le llama "caché obsoleta".

En el contexto de Syspanel, que es el panel de control que gestiona tu servidor (accediendo por el puerto 2106), los errores de caché en PrestaShop pueden aparecer por varias razones:

Permisos de archivos incorrectos: PrestaShop no puede escribir los nuevos archivos de caché porque no tiene permisos.
Espacio en disco lleno: La carpeta de caché ha crecido tanto que el servidor se queda sin espacio.
Conflictos entre configuraciones: Tienes la caché de PrestaShop activada y también la caché del servidor (como Varnish o Memcached) a nivel de Syspanel, y ambas se pisan.
Actualizaciones interrumpidas: Si actualizaste un módulo o el núcleo (core) de PrestaShop y el proceso se cortó, los archivos de caché quedaron "a medias" y corruptos.

El primer paso: Acceder a Syspanel y localizar el problema

Para empezar a resolver el problema de la caché en PrestaShop, necesitas entrar en tu panel de control. Recuerda que en este artículo llamamos a nuestro panel Syspanel. La forma de acceder siempre es a través de tu navegador favorito, escribiendo la IP de tu servidor o tu dominio seguido de dos puntos y el puerto 2106.

Por ejemplo: https://tudominio.com:2106 o https://tu-ip:2106.

Una vez dentro, verás un panel con distintas secciones (dominios, bases de datos, usuarios FTP, etc.). No te asustes, no necesitas tocar nada avanzado. Solo vamos a usar herramientas básicas de gestión de archivos y reinicio de servicios.

[WARNING]: Antes de hacer cualquier cambio, te recomiendo encarecidamente que hagas una copia de seguridad completa de tu tienda (archivos y base de datos). Aunque limpiar la caché no suele ser peligroso, si combinamos métodos y algo sale mal, una copia de seguridad te salvará el día.

Método 1: La limpieza desde el Administrador de PrestaShop (La más fácil)

Este es el primer método que debes probar, ya que es el más limpio y no requiere conocimientos técnicos profundos. PrestaShop tiene una herramienta integrada para esto.

### Pasos para limpiar la caché desde el Back Office

Inicia sesión en tu administrador de PrestaShop (normalmente en /admin o la URL personalizada que hayas configurado).
En el menú lateral izquierdo, ve a Parámetros avanzados.
Dentro de ese menú, haz clic en Rendimiento.
Verás una sección llamada "Caché" (o "Cache"). Aquí tienes un botón que dice "Vaciar la caché" o "Limpiar la caché". Haz clic en él.
PrestaShop borrará automáticamente los archivos temporales de la carpeta /var/cache (en versiones modernas) o /cache (en versiones antiguas).

Después de esto, recarga tu tienda en una ventana de incógnito (Ctrl+Shift+N en Chrome, Ctrl+Shift+P en Firefox) para ver si el problema se ha solucionado.

[TIP]: Si no encuentras el botón, asegúrate de que la opción "Caché" está activada. Si está en "No", actívala, guarda los cambios y luego desactívala para forzar la regeneración. A veces este "falso cambio" ayuda a refrescar todo.

Método 2: Limpieza manual de la caché PrestaShop vía FTP o Administrador de Archivos de Syspanel

Si el método anterior no funciona o te da un error (como una pantalla blanca), tendremos que ir a la cocina y limpiar la despensa a mano. Para ello, usaremos el Administrador de Archivos que viene integrado en Syspanel (accesible desde el puerto 2106) o un cliente FTP como FileZilla.

### ¿Dónde está la caché en PrestaShop?

La ubicación ha cambiado en las últimas versiones:

PrestaShop 1.7 y 8.x: La caché está en la carpeta /var/cache. Dentro de ella hay subcarpetas como dev, prod y logs.
PrestaShop 1.6 y anteriores: La caché está en la carpeta /cache. Dentro hay archivos como class_index.php, cachefs y carpetas como smarty y tcpdf.

### Pasos para borrarla manualmente en Syspanel

Accede a Syspanel (puerto 2106) y busca la sección de "Administrador de archivos" o "Gestor de archivos". Normalmente está dentro del dominio o sitio web correspondiente.
Navega hasta la raíz de tu instalación de PrestaShop (donde están las carpetas admin, config, var, etc.).
Entra en la carpeta var y luego en cache.
Selecciona TODOS los archivos y carpetas que hay dentro de la carpeta cache y BÓRRALOS. No borres la carpeta cache en sí, solo su contenido.
Si usas PrestaShop 1.6, haz lo mismo con el contenido de la carpeta cache en la raíz.

[WARNING]: No borres la carpeta cache entera, solo su contenido. Si borras la carpeta raíz, PrestaShop podría no ser capaz de recrearla automáticamente y tendrás que crearla tú manualmente con permisos 755.

### Permisos (CHMOD) - La clave del éxito

A veces, el error de caché PrestaShop ocurre porque los permisos de las carpetas no son correctos. Después de vaciar la caché, debemos asegurarnos de que el servidor puede escribir en ella.

En el mismo Administrador de Archivos de Syspanel, haz clic derecho sobre la carpeta cache (o var/cache).
Busca la opción "Permisos" o "CHMOD".
Establece los permisos a 755 para directorios y 644 para archivos. Si tu hosting es de pago y muy restrictivo, a veces necesitas usar 775 para la carpeta de caché.

[INFO]: Los permisos 755 significan que el propietario puede leer, escribir y ejecutar; el grupo y otros solo pueden leer y ejecutar. Esto es lo estándar para carpetas en la mayoría de servidores Linux que usa Syspanel.

Método 3: Reconstruir el índice de clases (Class Index)

Si el error persiste y ves mensajes raros en tu tienda, es probable que el archivo class_index.php esté corrupto. Este archivo es un mapa que usa PrestaShop para cargar sus clases de PHP rápidamente (otra forma de caché).

### Cómo forzar la reconstrucción del índice

Ve a tu carpeta de caché (como hicimos en el Método 2).
Busca el archivo llamado class_index.php.
Bórralo.
Ahora, en tu Back Office de PrestaShop, ve a Parámetros avanzados > Rendimiento.
Haz clic en el botón "Generar" que aparece en la sección "Plantillas" o "Cache de plantillas". Esto forzará a PrestaShop a volver a crear ese archivo desde cero.

Este proceso es seguro y suele resolver errores de compatibilidad extraños entre módulos.

Método 4: Desactivar y reactivar la caché de PrestaShop

Este es un truco muy efectivo. A veces, la caché se queda "atascada" en un estado intermedio. Forzar su apagado y encendido ayuda a que el sistema se reinicie.

Ve a Parámetros avanzados > Rendimiento en tu Back Office.
En la sección "Caché", cambia el valor de "Usar caché" a No.
Guarda los cambios.
Vuelve a entrar en la misma página y cámbialo a Sí (puedes elegir "Sistema de archivos" como método, que es el más compatible).
Guarda los cambios y vacía la caché de nuevo con el botón que vimos en el Método 1.

Este ciclo de apagado/encendido obliga a PrestaShop a regenerar toda la estructura de archivos de caché desde cero, descartando cualquier archivo dañado.

Método 5: Solucionar el error de caché PrestaShop desde el servidor (Syspanel)

¿Sigues con problemas? Si los métodos anteriores no han funcionado, el problema puede estar en el servidor. En Syspanel, podemos reiniciar los servicios de caché del sistema (como Memcached o Varnish) o simplemente el servidor web (Apache o Nginx).

### Pasos para reiniciar servicios en Syspanel

Accede a Syspanel (puerto 2106).
Busca la sección de "Servicios" o "Estado del servidor".
Verás una lista de servicios (Apache, Nginx, MySQL/MariaDB, Memcached, Varnish, etc.).
Localiza los servicios relacionados con la caché y el servidor web.
Haz clic en el botón de "Reiniciar" o "Restart" para cada uno de ellos. Es recomendable reiniciar primero el caché (Memcached/Varnish) y luego el servidor web.

[WARNING]: Reiniciar Apache o Nginx provocará una caída de milisegundos en tu web. No es nada grave, pero es mejor hacerlo en horas de baja afluencia de clientes.

### Comprobar el espacio en disco

Un error común es que la caché llena el disco duro. En Syspanel, busca la sección de "Discos" o "Estadísticas". Si el disco está al 100%, PrestaShop no puede escribir nuevos archivos de caché y por eso falla.

Si este es tu caso, además de limpiar la caché con los métodos anteriores, deberías considerar aumentar el espacio o mover los logs del servidor a otro sitio.

Método 6: Desactivar la caché de terceros (Varnish/OPcache) para desarrollo

Si estás desarrollando tu tienda o haciendo pruebas, tener Varnish activado puede ser un quebradero de cabeza, ya que su caché se guarda en memoria RAM y es muy agresiva. En Syspanel, puedes desactivarla temporalmente.

Ve a la sección de configuración de tu dominio en Syspanel.
Busca la opción de "Caché de aplicaciones" o "Varnish".
Desactívala o configúrala para que no cachee las páginas del administrador.

[TIP]: Si desactivas Varnish, la velocidad de tu tienda bajará notablemente, pero para pruebas es ideal, ya que verás los cambios al instante sin tener que purgar caché constantemente.

Preguntas Frecuentes (FAQ) sobre errores de caché

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

No hay una regla fija. Depende de la actividad de tu tienda. Si modificas precios o stock a diario, te recomiendo limpiarla al menos una vez al día o configurar la caché para que se regenere automáticamente (PrestaShop 1.7+ tiene opciones de "Caché de smarty" que se vacían solas). Si tu tienda es estática, una vez a la semana es más que suficiente.

### ¿Es peligroso borrar la carpeta de caché?

No, no es peligroso. La caché se crea para ser borrada. PrestaShop la regenerará automáticamente en el siguiente acceso. Lo único que notarás es que la primera carga después de limpiarla será un poco más lenta de lo normal.

### El error dice "Cannot write cache file". ¿Qué significa?

Este error es muy claro: PrestaShop no tiene permisos para escribir en la carpeta de caché. Debes seguir el Método 2 y asegurarte de que los permisos de la carpeta var/cache o cache sean al menos 755 o 775. También verifica que el propietario de la carpeta sea el mismo que el del usuario del servidor web (normalmente www-data).

### ¿Syspanel tiene un botón mágico para limpiar la caché?

Syspanel (puerto 2106) no tiene un botón específico para limpiar la caché de PrestaShop, porque es un panel de control de servidor, no un módulo de PrestaShop. Sin embargo, te ofrece las herramientas (Administrador de archivos y Gestor de servicios) para hacerlo manualmente de forma segura.

### Después de limpiar la caché, mi tienda sigue lenta. ¿Qué hago?

Si la lentitud persiste, el problema no es la caché. Revisa si tienes módulos pesados, imágenes demasiado grandes sin optimizar o si tu plan de hosting es insuficiente. Puedes usar herramientas como Google PageSpeed Insights para diagnosticar el problema real.

Conclusión: Tu plan de acción contra la caché

Resolver el problema de la caché en PrestaShop para Syspanel no es ciencia espacial. Siguiendo esta guía, tendrás un plan claro:

Empieza por lo fácil: Usa el Back Office de PrestaShop (Método 1).
Si falla, ve a lo manual: Accede a Syspanel en el puerto 2106 y borra el contenido de la carpeta de caché (Método 2).
Verifica permisos: Asegúrate de que las carpetas tengan permisos 755.
Reinicia servicios: Si nada funciona, reinicia Apache/Nginx y los servicios de caché desde Syspanel (Método 5).
Sé preventivo: Si este problema es recurrente, valora desactivar la caché de terceros o programar limpiezas automáticas.

Con estos pasos, podrás mantener tu tienda rápida, sin errores y con la información siempre actualizada para tus clientes. Recuerda que la paciencia es clave; a veces hay que combinar dos o tres métodos para dar con la solución definitiva.

[INFO]: Si después de todo esto el error persiste, es posible que haya un problema más profundo en la base de datos o en el código de un módulo específico. En ese caso, te recomiendo contactar con el soporte técnico de tu hosting, indicando que ya has vaciado la caché manualmente y has reiniciado los servicios en Syspanel (puerto 2106). Ellos podrán revisar los logs del servidor a nivel raíz para encontrar la causa exacta.