¿Qué es el error 'Exception printing is disabled by default' en Magento 2?
El mensaje 'Exception printing is disabled by default for security reasons' es una pantalla genérica de error en Magento 2. Su propósito principal es proteger la seguridad de la tienda e-commerce evitando que usuarios no autorizados o atacantes vean información sensible del servidor, rutas de archivos o credenciales de la base de datos cuando ocurre una falla crítica.
Cuando aparece este aviso, Magento genera un archivo de registro (log) en el servidor que contiene el informe detallado del problema (conocido como report file). Para solucionar el fallo real que bloquea la tienda, primero es necesario habilitar la visualización de errores o consultar dichos registros.
Causas principales del problema
- Conflictos en módulos o extensiones de terceros: Instalaciones recientes o actualizaciones de módulos incompatibles con la versión actual de Magento.
- Errores en la compilación de dependencias: Archivos generados de forma incompleta durante el comando setup:di:compile.
- Problemas de permisos de archivos y carpetas: Permisos incorrectos en var/, generated/ o pub/static/.
- Sintaxis o caché corrupta: Archivos en la caché de Magento o Redis/Varnish que no se han limpiado tras un cambio de código.
Método 1: Renombrar el archivo local.xml.sample para ver el error en pantalla
La forma más rápida de diagnosticar la falla sin acceder por SSH a revisar los logs es permitir que Magento muestre la traza completa del error directamente en el navegador.
- Conéctate a tu servidor mediante FTP, SFTP o el Administrador de Archivos de cPanel.
- Navega hasta el directorio raíz de tu instalación de Magento 2 y entra en la carpeta
pub/errors/. - Busca el archivo llamado
local.xml.sampley cámbiale el nombre alocal.xml. - Recarga la página web de tu tienda Magento en el navegador. Ahora verás la traza exacta del error PHP en lugar de la pantalla genérica.
Una vez identificado y solucionado el fallo, es recomendable volver a cambiar el nombre del archivo a local.xml.sample en entornos de producción para proteger tu tienda.
Método 2: Cambiar a modo Desarrollador mediante la CLI de Magento
Si tienes acceso a la consola de comandos SSH, cambiar el modo de trabajo de Magento a developer activará el reporte detallado de errores automáticamente.
- Abre tu terminal SSH y dirígete al directorio raíz de tu proyecto Magento 2.
- Ejecuta el siguiente comando para cambiar el modo de la aplicación:
php bin/magento deploy:mode:set developer- Limpia la caché del sistema ejecutando:
php bin/magento cache:flush- Actualiza la tienda en el navegador para inspeccionar el mensaje de error completo y localizar el módulo o archivo defectuoso.
Método 3: Recompilar la tienda y corregir permisos
Una vez que identificas el módulo o archivo que causa la excepción, el siguiente paso habitual para solucionar fallos de inyección de dependencias o compilación es regenerar el código ejecutable y ajustar los permisos.
- Ejecuta la recompilación de dependencias en la terminal:
php bin/magento setup:di:compile- Ejecuta la actualización del esquema y los datos:
php bin/magento setup:upgrade- Asegúrate de asignar los permisos correctos a las carpetas críticas de Magento 2 escribiendo:
chmod -R 775 var generated pub/static pub/media- Finalmente, vuelve a cambiar al modo producción para optimizar el rendimiento:
php bin/magento deploy:mode:set production