¿Qué es la Excepción Localizada en Magento 2 y Por Qué Ocurre?
El error de excepción localizada en Magento 2 (Localized Exception) es uno de los problemas más comunes a los que se enfrentan los desarrolladores y administradores de tiendas e-commerce. Este fallo interrumpe la ejecución normal del sistema y suele mostrar un mensaje genérico en la interfaz de usuario, ocultando en ocasiones el verdadero origen del problema técnico.
Las causas principales de este error están relacionadas con fallos en la compilación de la inyección de dependencias, problemas de permisos en los archivos del sistema, errores en módulos de terceros o fallos temporales en la caché y el almacenamiento en Redis o Varnish.
Método 1: Limpiar y vaciar la caché de Magento
Muchas excepciones localizadas se deben a discrepancias entre los datos almacenados en caché y los archivos modificados recientemente en el servidor. Para solucionarlo, debes limpiar la caché ejecutando los siguientes comandos mediante SSH:
- Accede a tu servidor mediante SSH utilizando tus credenciales de acceso.
- Navega hasta la raíz de tu instalación de Magento utilizando el comando
cd /ruta/a/tu/magento. - Ejecuta el comando de limpieza de caché:
php bin/magento cache:clean. - Limpia el almacenamiento de caché con:
php bin/magento cache:flush.
Método 2: Compilar el código y actualizar la inyección de dependencia
Cuando instalas nuevos módulos o actualizas componentes, es vital recompilar el código de la aplicación para evitar excepciones por clases no encontradas o errores de compilación.
- Abre la terminal SSH y dirígete al directorio raíz de Magento.
- Ejecuta el comando para compilar las clases del código fuente:
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.
Método 3: Ajustar los permisos de archivos y carpetas
Magento 2 requiere permisos de escritura y lectura muy estrictos en directorios específicos como generated, var y pub/static. Un error de permisos puede desencadenar una excepción localizada al intentar escribir archivos de registro o caché.
- Ejecuta el siguiente comando para asignar el propietario correcto al servidor web (ejemplo para Apache/Nginx):
sudo chown -R www-data:www-data . - Establece los permisos correctos para los directorios ejecutando:
find . -type d -p 755yfind . -type f -p 644. - Otorga permisos de escritura recursiva a las carpetas críticas:
chmod -R 775 var generated pub/static.