Cómo Solucionar el Error 'Exception printing is disabled' en Magento de Forma Definitiva

Introducción al Error de Excepciones en Magento

Cuando administras una tienda online en Magento, es común encontrarse con la temida página que muestra el mensaje genérico: There has been an error processing your request junto con un código de reporte numérico. Esto ocurre porque Magento oculta los detalles técnicos por defecto para proteger la seguridad del sitio. En este artículo te mostraremos cómo habilitar el registro de errores y solucionar la causa raíz de forma definitiva.

Principales Causas del Problema

Las razones más comunes por las que Magento genera esta excepción en el frontend o backoffice son:

• Fallo en la conexión con la base de datos o credenciales incorrectas en app/etc/env.php.
• Permisos de archivos y carpetas incorrectos en el servidor web.
• Errores de sintaxis o fallas críticas en módulos instalados recientemente.
• Falta de memoria RAM o timeout en procesos de compilación o indexación.

Método 1: Habilitar la Impresión de Excepciones para Ver el Error Real

Para saber exactamente qué está fallando, necesitamos activar la visualización del error modificando un archivo de configuración:

1. Accede a los archivos de tu tienda Magento mediante SSH o tu cliente FTP preferido.
2. Navega hasta la carpeta raíz de instalación de Magento y luego entra al directorio pub/.
3. Busca el archivo llamado local.xml.sample o verifica si existe una carpeta errors/.
4. Si estás en Magento 2, renombra el archivo pub/errors/local.xml.sample a pub/errors/local.xml.
5. Si usas un editor de texto, asegúrate de cambiar el modo de reporte de errores abriendo el archivo pub/errors/local.xml y cambiando el valor predeterminado a developer.
6. Actualiza tu navegador y recarga la página para ver el error exacto en lugar del mensaje genérico.

Método 2: Corregir Permisos de Archivos y Carpetas

Un error común que bloquea Magento es la falta de permisos adecuados de escritura en las carpetas clave del sistema. Ejecuta los siguientes comandos mediante SSH:

1. Abre tu terminal SSH y conéctate al servidor de tu tienda.
2. Navega hasta la ruta raíz de Magento: cd /var/www/html/tu-tienda-magento
3. Establece los permisos correctos para los directorios ejecutando: find var generated vendor pub/static pub/media app/etc -type f -exec chmod 664 {} +
4. Aplica permisos para las carpetas con: find var generated vendor pub/static pub/media app/etc -type d -exec chmod 775 {} +
5. Dale permisos de ejecución al comando binario de Magento: chmod u+x bin/magento
6. Limpia la caché del sistema para aplicar los cambios: php bin/magento cache:clean

Método 3: Compilación y Limpieza de Caché

Si el error persiste después de revisar los permisos, a corrupción en la caché o en la inyección de dependencias suele ser el detonante:

1. Accede nuevamente por SSH a la raíz de tu proyecto Magento.
2. Ejecuta el comando para limpiar el almacenamiento temporal: php bin/magento cache:flush
3. Vuelve a compilar el código de la aplicación con: php bin/magento setup:di:compile
4. Despliega los contenidos estáticos si el problema afecta a los estilos o JavaScript: php bin/magento setup:static-content:deploy -f
5. Verifica el estado de la tienda recargando el sitio web en modo incógnito.