Cómo Solucionar el Error 'Exception printing is available in reports' en Magento de Forma Definitiva

Introducción al Error de Excepciones en Magento

Uno de los mensajes más frustrantes al administrar una tienda en línea basada en Magento es encontrarse con la pantalla de error genérica que indica: Exception printing is available in reports junto con un número de informe. Este aviso de seguridad oculta el error real de PHP o de la base de datos por razones de seguridad, impidiendo que los administradores identifiquen rápidamente qué está fallando en el sistema e-commerce.

Principales Causas del Problema

Este comportamiento predeterminado en Magento se activa cuando ocurre una excepción no capturada en el núcleo, en un módulo de terceros o debido a problemas de conectividad con la base de datos o sistemas de caché como Redis. Las causas más comunes incluyen:

• Fallo en la conexión con el servidor MySQL o límites de consultas excedidos.
• Errores de sintaxis o conflictos en módulos recientemente instalados o actualizados.
• Permisos incorrectos en el sistema de archivos del directorio var/report o var/cache.
• Falta de memoria RAM asignada a PHP (Memory Limit).

Método 1: Consultar el Archivo de Reporte para Identificar la Excepción Real

Para solucionar el problema, primero debes leer el código de error generado por Magento. Sigue estos pasos:

1. Accede a tu servidor mediante SSH o utiliza el Administrador de Archivos de tu Hosting.
2. Navega hasta la raíz de tu instalación de Magento y entra en la carpeta var/report/.
3. Busca el archivo cuyo nombre coincida con el número de informe que aparece en pantalla (por ejemplo, report-1234567890123).
4. Abre el archivo con un editor de texto o mediante la terminal ejecutando: cat var/report/1234567890123.
5. Analiza la traza de la pila (stack trace) para identificar qué archivo, módulo o función está provocando la excepción.

Método 2: Habilitar el Modo Desarrollador (Developer Mode)

Si necesitas ver los errores directamente en pantalla mientras depuras el problema, puedes cambiar el modo de Magento a Desarrollador ejecutando el siguiente comando en tu terminal SSH:

1. Conéctate a la terminal SSH de tu servidor y dirígete al directorio raíz de Magento.
2. Ejecuta el comando para cambiar el modo: php bin/magento deploy:mode:set developer
3. Limpiar la caché para aplicar los cambios: php bin/magento cache:clean
4. Actualiza la página en tu navegador web y ahora verás el error detallado de PHP en lugar del mensaje genérico.

Método 3: Corregir Permisos de Archivos y Limpiar la Caché

A menudo, las excepciones ocurren porque Magento no puede escribir en sus directorios temporales. Restaura los permisos correctos ejecutando los siguientes comandos en tu terminal:

1. Asigna los permisos correctos a las carpetas var, generated y pub/static: find var generated pub/static -type f -exec chmod 664 {} +
2. Ejecuta el comando para directorios: find var generated pub/static -type d -exec chmod 775 {} +
3. Asegúrate de que el usuario del servidor web sea el propietario: sudo chown -R www-data:www-data . (reemplaza www-data por el usuario correspondiente a tu servidor como nginx o apache).
4. Limpia y recompile la aplicación: php bin/magento setup:upgrade y php bin/magento cache:flush.