Introducción al Error de Excepción y Caché en Magento
Uno de los problemas más frustrantes a los que se enfrentan los administradores de tiendas en línea es encontrarse con una pantalla de error genérica en Magento que indica un fallo en la excepción o problemas relacionados con la lectura y escritura de archivos en la caché. Este inconveniente detiene por completo el funcionamiento del sitio web, afectando directamente las ventas y la experiencia del usuario.
Causas Principales del Error
El origen de este fallo en Magento suele estar vinculado a diversos factores técnicos comunes en entornos de producción y desarrollo:
- Permisos incorrectos en las carpetas
var/ygenerated/. - Corrupción en el almacenamiento temporal de Redis, Varnish o la caché integrada.
- Falta de memoria asignada a PHP para procesar las compilaciones y los bloques de la tienda.
- Modificaciones recientes en archivos de configuración XML o instalación de módulos incompatibles.
Método 1: Restablecer los Permisos de Archivos y Carpetas
Para solucionar problemas de lectura y escritura que generan excepciones de caché, debes acceder a tu servidor mediante SSH y ejecutar los siguientes comandos para corregir los permisos:
- Navega hasta la raíz de tu instalación de Magento utilizando la terminal:
cd /var/www/html/tu-tienda-magento - Asigna los permisos correctos a las carpetas críticas:
find var generated vendor pub/static pub/media -type f -exec chmod 664 {} + - Ejecuta el comando para directorios:
find var generated vendor pub/static pub/media -type d -exec chmod 775 {} + - Asegúrate de que el usuario del servidor web sea el propietario:
sudo chown -R www-data:www-data .
Método 2: Limpiar y Vaciar la Caché por Consola (CLI)
Cuando el panel de administración (Admin) no responde debido a una excepción, la limpieza manual mediante la interfaz de comandos SSH es la solución más efectiva.
- Entra a la raíz de tu Magento vía SSH.
- Ejecuta el comando para limpiar el almacenamiento temporal:
php bin/magento cache:clean - Elimina por completo el contenido de las carpetas de caché y metadatos:
rm -rf var/cache/* var/generation/* var/di/* var/page_cache/* - Vuelve a generar la compilación de inyección de dependencias:
php bin/magento setup:di:compile
Método 3: Reiniciar y Verificar el Servidor de Caché (Redis / Varnish)
Si tu tienda Magento utiliza sistemas externos como Redis para gestionar las sesiones o la caché de objetos, un fallo en el servicio provocará errores fatales de excepción.
- Conéctate a tu servidor y verifica el estado de Redis:
sudo systemctl status redis-server - Si el servicio está detenido o presenta fallos, reinícialo:
sudo systemctl restart redis-server - Si utilizas Varnish, comprueba su estado con:
sudo systemctl status varnishy reinícialo si es necesario:sudo systemctl restart varnish - Finalmente, actualiza los índices de Magento para asegurar la sincronización:
php bin/magento indexer:reindex