Introducción al Error de Excepción en Magento
Uno de los problemas más frustrantes para los administradores de tiendas en línea basadas en Magento es encontrarse con una pantalla de error genérica o mensajes de excepción relacionados con la compilación y la caché. Estos fallos suelen aparecer tras realizar actualizaciones de módulos, migraciones de servidores o modificaciones en la base de datos.
Causas Principales del Problema
Las razones más comunes por las que Magento genera excepciones de caché y compilación incluyen:
- Desincronización entre la base de datos y el sistema de archivos del código fuente.
- Caché obsoleta almacenada en Redis o Varnish.
- Dependencias de inyección de código que no han sido compiladas correctamente.
- Permisos incorrectos en las carpetas
generated,varypub/static.
Método 1: Limpieza Profunda de Caché y Directorios Generados
El primer paso para solucionar este inconveniente es eliminar los archivos temporales y forzar a Magento a regenerarlos mediante la consola SSH.
- Accede a tu servidor mediante SSH utilizando tus credenciales de usuario.
- Navega hasta la raíz de tu instalación de Magento:
cd /var/www/html/tu-tienda-magento - Ejecuta el comando para limpiar la caché:
php bin/magento cache:clean - Elimina el contenido de las carpetas generadas para evitar conflictos:
rm -rf var/cache/* var/page_cache/* generated/code/*
Método 2: Compilación y Actualización de Dependencias (DI Compile)
Si el error persiste, es muy probable que la inyección de dependencias (Dependency Injection) esté incompleta. Sigue estos pasos:
- Asegúrate de estar en la raíz de tu proyecto Magento en la terminal SSH.
- Ejecuta el comando de compilación de producción:
php bin/magento setup:di:compile - Despliega los contenidos estáticos necesarios para el correcto funcionamiento del frontend y backend:
php bin/magento setup:static-content:deploy -f - Vuelve a limpiar la caché para aplicar los cambios:
php bin/magento cache:flush
Método 3: Corrección de Permisos de Archivos
Los permisos restrictivos o mal configurados impiden que Magento escriba en los directorios temporales, generando excepciones en cadena.
- Asigna el propietario correcto al servidor web (ejemplo para Apache/Nginx):
sudo chown -R www-data:www-data . - Establece los permisos adecuados para los directorios:
find . -type d -exec chmod 755 {} + - Establece los permisos adecuados para los archivos:
find . -type f -exec chmod 644 {} + - Vuelve a probar tu tienda en el navegador para verificar que el error ha desaparecido por completo.