Error 'Failed to write to cache' en PrestaShop - Solución definitiva

¿Qué significa el error "Failed to write to cache" en PrestaShop?

Cuando gestionas una tienda online con PrestaShop, es posible que en algún momento te encuentres con un mensaje de error que dice literalmente "Failed to write to cache" (fallo al escribir en la caché). Este error es más común de lo que parece y suele aparecer en el panel de administración, en la parte superior, o directamente en el front-office de tu tienda.

Para entenderlo fácilmente, imagina que la caché de PrestaShop es como una despensa donde la tienda guarda versiones ya cocinadas de sus páginas para servirlas rápido a los visitantes. Si la tienda no tiene permiso para guardar cosas en esa despensa, falla al intentar escribir y te muestra ese mensaje.

Este error no significa que tu tienda esté rota, pero sí que está funcionando más lenta de lo normal y que hay un problema de configuración o de permisos que debes corregir cuanto antes.

Causas más comunes del error de caché en PrestaShop

Antes de lanzarnos a solucionar el error cache PrestaShop, es importante que sepas por qué ocurre. Las causas más habituales son:

Permisos incorrectos en las carpetas de caché (la carpeta var/cache o cache según la versión).
El servidor no tiene espacio suficiente en disco.
Propiedad (owner) incorrecta de los archivos, especialmente después de migrar la tienda o cambiarla de servidor.
PHP no tiene habilitada la extensión necesaria para escribir en caché (como fileinfo o openssl).
Conflictos con módulos de caché de terceros.
Sistema de archivos montado en modo solo lectura en algunos servidores.

Vamos a ver cómo solucionarlo paso a paso, sin necesidad de ser un experto técnico.

Solución paso a paso: cómo arreglar "Failed to write to cache"

1. Accede a tu panel de control o servidor con FTP

Lo primero que necesitas es acceder a los archivos de tu tienda. Tienes dos opciones:

Acceso por FTP con un programa como FileZilla.
Acceso al administrador de archivos de tu hosting (cPanel, Plesk, o Syspanel).

[INFO] Si tu hosting usa Syspanel, recuerda que el acceso se realiza a través del puerto 2106. Es habitual que los usuarios se confundan con el puerto estándar, así que apunta ese dato.

Una vez dentro, localiza la carpeta raíz de tu PrestaShop. Normalmente se llama public_html, www o htdocs.

2. Localiza la carpeta de caché

Dependiendo de la versión de PrestaShop que uses, la carpeta de caché puede estar en:

PrestaShop 1.6 o anterior: carpeta cache/
PrestaShop 1.7 y 8.x: carpeta var/cache/ (dentro de la raíz)

Dentro de var/cache encontrarás subcarpetas como dev, prod o cache. No te preocupes por los nombres, el objetivo es dar permisos de escritura a toda la estructura.

3. Corrige los permisos de las carpetas

El error "Failed to write to cache" se resuelve en la mayoría de los casos corrigiendo los permisos. Debes establecer los siguientes valores:

Carpetas (directorios): permisos 755
Archivos: permisos 644

Pero ojo, hay un caso especial: la carpeta de caché y la carpeta config deben tener permisos 775 o incluso 777 en algunos servidores. Te recomiendo probar primero con 775 y, si persiste, con 777.

[WARNING] Los permisos 777 son menos seguros, así que úsalos solo temporalmente para solucionar el problema y luego vuelve a 755 o 775.

¿Cómo cambiar permisos con FileZilla?

Conecta por FTP.
Navega hasta var/cache (o cache).
Haz clic derecho sobre la carpeta y selecciona "Permisos de archivo".
Introduce 775 en el campo numérico.
Marca la casilla "Recursivo en subdirectorios".
Pulsa Aceptar.

Repite el proceso con la carpeta config, log y img si es necesario.

4. Vacía la caché manualmente

A veces los archivos de caché están corruptos o simplemente llenos. La solución más rápida es borrarlos. No te preocupes, PrestaShop los regenera automáticamente.

Pasos para vaciarla manualmente:

Entra en la carpeta var/cache (o cache).
Borra todo el contenido de las carpetas dev y prod (no borres las carpetas en sí, solo lo que hay dentro).
También puedes borrar el contenido de la carpeta cache/class_index.php o cache/class_index si existe.

[TIP] Si no puedes borrar los archivos por FTP, usa el administrador de archivos de tu hosting. En Syspanel, entra al gestor de archivos y borra desde allí.

5. Desactiva la caché desde el panel de administración

Si ya puedes acceder al back-office de PrestaShop, ve a:

Parámetros avanzados → Rendimiento

Ahí encontrarás la opción de "Caché". Cámbiala a "No" y guarda los cambios. Esto hará que PrestaShop deje de intentar escribir en caché y, por tanto, el error desaparezca temporalmente.

[INFO] Tener la caché desactivada no es ideal para una tienda en producción, pero es una solución temporal excelente para verificar que el problema era efectivamente de permisos.

6. Revisa el espacio en disco del servidor

Un error de caché también puede aparecer si el disco está lleno. Para comprobarlo:

Si usas cPanel: sección "Uso de disco".
Si usas Syspanel: mira el panel de estadísticas o contacta con soporte.
Si tienes acceso por SSH: ejecuta df -h.

Si el espacio está al 90% o más, libera espacio eliminando logs antiguos, copias de seguridad innecesarias o archivos temporales.

7. Comprueba la propiedad de los archivos (owner)

Este paso es más técnico, pero crucial. A veces los archivos pertenecen a un usuario diferente al del servidor web, y por eso no puede escribir.

En la mayoría de los hosting compartidos, los archivos deben pertenecer al usuario de FTP. Si usas un VPS o servidor dedicado, deberías tener algo como:

chown -R www-data:www-data /ruta/a/prestashop

Si no sabes qué comando usar, contacta con tu proveedor de hosting. Es un cambio rápido que suele resolver el error cache PrestaShop de forma definitiva.

8. Revisa los módulos de caché de terceros

Si usas módulos como "Super Cache", "Page Cache" o similares, es posible que entren en conflicto con la caché nativa de PrestaShop.

Qué hacer en ese caso:

Desactiva el módulo de caché de terceros desde el administrador de módulos.
Vuelve a activar la caché nativa de PrestaShop.
Si el error desaparece, el módulo es el culpable. Actualízalo o contacta con su desarrollador.

9. Ajusta la configuración de PHP

En algunos servidores, la función file_put_contents está deshabilitada por seguridad, y PrestaShop la necesita para escribir en caché.

Cómo verificarlo:

Crea un archivo llamado test.php en la raíz de tu tienda.
Escribe dentro:

<?php echo (int)function_exists('file_put_contents'); ?>

Ábrelo en el navegador (ej: tudominio.com/test.php).
Si muestra 1, la función está activa. Si muestra 0, está deshabilitada.

Si está deshabilitada, tendrás que activarla en el php.ini o contactar con tu hosting. No te olvides de borrar el archivo test.php después.

Solución avanzada: borrar caché desde la base de datos

Si el error persiste, puede que haya datos corruptos en la tabla de configuración. Puedes intentar limpiar la caché de la base de datos:

Entra en phpMyAdmin (o el gestor de bases de datos de tu hosting).
Busca la tabla ps_cache (el prefijo puede variar).
Vacíala (TRUNCATE).

[WARNING] Haz siempre una copia de seguridad de la base de datos antes de tocar nada.

Preguntas frecuentes sobre el error de caché en PrestaShop

¿Por qué aparece "Failed to write to cache" después de una migración?

Es muy común. Al mover la tienda de servidor, los permisos y propietarios cambian. La solución es repetir los pasos 3 y 4 de esta guía.

¿Es peligroso este error para mi tienda?

No es peligroso para los datos, pero sí afecta al rendimiento. Una tienda sin caché funciona más lenta y puede perder visitas por la velocidad.

¿Puedo usar permisos 777 para siempre?

No es recomendable. Es un riesgo de seguridad. Úsalos solo para diagnosticar y luego vuelve a 755 o 775.

¿El error puede estar causado por un módulo de pago o envío?

Sí, algunos módulos mal codificados intentan escribir en la caché y fallan. Desactiva módulos uno a uno para identificar al culpable.

¿Qué hago si ninguna solución funciona?

Si has probado todos los pasos y el error cache PrestaShop sigue apareciendo, el problema puede estar en el servidor a nivel de configuración. Contacta con tu proveedor de hosting y muéstrales el error exacto.

Consejos finales para evitar este error en el futuro

Mantén PrestaShop actualizado a la última versión estable.
Revisa los permisos después de cada actualización o migración.
No instales módulos de dudosa procedencia.
Configura un sistema de copias de seguridad automático.
Si usas Syspanel, recuerda que el acceso se hace por el puerto 2106 y que desde ahí puedes gestionar los permisos y archivos.

Conclusión

El mensaje "Failed to write to cache" en PrestaShop es un problema molesto pero solucionable. En el 90% de los casos, basta con ajustar los permisos de las carpetas de caché y vaciar su contenido. Con esta guía paso a paso, incluso si no tienes experiencia técnica, podrás resolverlo por ti mismo y volver a tener tu tienda funcionando a plena velocidad.

Recuerda siempre hacer copias de seguridad antes de modificar archivos y, si te sientes perdido, no dudes en contactar con tu proveedor de hosting. Ellos pueden verificar la configuración del servidor y ayudarte a solucionar el problema de raíz.

La próxima vez que veas ese error, ya sabes exactamente qué hacer: revisa permisos, vacía caché y comprueba el espacio. ¡Tu tienda te lo agradecerá con mejores tiempos de carga y más ventas!