Cómo Solucionar el Error Exception Local Action en Magento 2 Paso a Paso

¿Qué es el Error Exception Local Action en Magento 2?

El error Exception Local Action en Magento 2 suele aparecer de manera repentina en el panel de administración (Admin) o durante la navegación en el frontend, interrumpiendo la experiencia de usuario y bloqueando ciertas operaciones críticas. Este fallo está estrechamente vinculado a problemas de permisos de archivos, compilación incompleta de clases o discrepancias en la caché del sistema.

Causas Principales del Error

Identificar el origen del problema es fundamental para aplicar la solución adecuada. Las causas más comunes incluyen:

• Falta de permisos de escritura en las carpetas generated, var y pub/static.
• Archivos de caché y objetos generados corruptos o desactualizados.
• Problemas durante el despliegue de contenido estático o compilación de dependencias por CLI.

Método 1: Limpieza y Recreación de la Caché y Directorio Generated

La acumulación de datos obsoletos en las carpetas del sistema es la causa principal de este error. Sigue estos pasos vía SSH para solucionarlo:

1. Accede a tu servidor mediante SSH utilizando tus credenciales de usuario (asegúrate de usar el usuario propietario del sistema de archivos, no root).
2. Navega hasta la raíz de tu instalación de Magento: cd /ruta/a/tu/magento.
3. Elimina el contenido de las carpetas problemáticas ejecutando los siguientes comandos:
   rm -rf var/cache/* var/page_cache/* var/generation/* generated/*
4. Vuelve a limpiar la caché desde la consola de Magento:
   php bin/magento cache:clean
5. Verifica si el error ha desaparecido accediendo nuevamente a tu tienda.

Método 2: Ajuste Correcto de Permisos de Archivos

Un error clásico en Magento 2 son los permisos incorrectos, lo que impide que el framework escriba acciones locales. Ejecuta el siguiente conjunto de comandos en tu terminal SSH:

1. Establece los permisos correctos para directorios y archivos ejecutando:
   find . -type d -exec chmod 755 {} +
find . -type f -exec chmod 644 {} +
2. Asigna los permisos específicos de escritura a las carpetas críticas de Magento:
   chmod -R 775 var pub/static generated
3. Asegúrate de que el usuario web (por ejemplo, www-data o nginx) sea el propietario de los archivos:
   sudo chown -R tu_usuario:tu_grupo .

Método 3: Recompilación y Despliegue de Contenido Estático

Si los métodos anteriores no surten efecto, es muy probable que el entorno de producción necesite una recompilación completa del código:

1. Activa el modo mantenimiento para evitar conflictos:
   php bin/magento maintenance:enable
2. Ejecuta el comando de compilación de producción:
   php bin/magento setup:di:compile
3. Despliega los archivos estáticos necesarios:
   php bin/magento setup:static-content:deploy -f
4. Desactiva el modo mantenimiento:
   php bin/magento maintenance:disable

Con estos sencillos pasos, habrás resuelto el error Exception Local Action y tu tienda Magento 2 volverá a funcionar con total normalidad.