¿Qué es el error Exception Print-ID en Magento 2?
Cuando administras una tienda online en Magento 2, es muy común encontrarte de repente con un mensaje genérico en pantalla que indica: 'Report ID: webapi-... Error log record number...' o simplemente una pantalla de excepción con un código identificador. Esto ocurre porque Magento oculta los detalles reales del error por motivos de seguridad en el entorno de producción, generando un archivo de registro en el servidor que debes analizar para resolver el problema.
Causas principales del error de excepciones en Magento
Las causas más habituales que desencadenan este fallo en Magento 2 incluyen:
- Falta de compilación de código o dependencias desactualizadas tras instalar un módulo.
- Permisos incorrectos en los directorios
var,pub/staticygenerated. - Conflictos de memoria RAM o PHP al ejecutar procesos pesados.
- Errores de sintaxis o incompatibilidades en extensiones de terceros.
Método 1: Localizar el archivo de reporte en el servidor
Para saber exactamente qué está fallando, debes leer el archivo de registro generado por Magento 2 usando acceso SSH:
- Conéctate a tu servidor mediante SSH utilizando tu cliente favorito (como PuTTY o Terminal).
- Navega hasta la raíz de tu instalación de Magento (por ejemplo,
cd /var/www/html/tu-tienda-magento). - Entra en la carpeta
var/report/buscando el archivo cuyo nombre coincide con el identificador numérico que apareció en la pantalla de error. - Abre el archivo utilizando un editor de texto o el comando
cat var/report/NUMERO_DE_REPORTEpara leer la traza completa de la excepción (stack trace) y detectar qué archivo o clase PHP provocó el fallo.
Método 2: Limpiar la caché y regenerar la compilación
Muchas excepciones ocurren porque la caché o los archivos generados están corruptos. Ejecuta los siguientes comandos en tu terminal para solucionarlo:
- Limpia la caché de Magento ejecutando:
php bin/magento cache:cleanyphp bin/magento cache:flush. - Elimina los archivos generados previamente con:
rm -rf generated/code/* generated/metadata/*. - Vuelve a compilar la aplicación ejecutando:
php bin/magento setup:di:compile. - Despliega los recursos estáticos si es necesario con:
php bin/magento setup:static-content:deploy -f.
Método 3: Ajustar correctamente los permisos de archivos y directorios
Un problema clásico de excepciones y errores 500 en Magento 2 son los permisos restrictivos o incorrectos. Aplica los permisos recomendados por la documentación oficial ejecutando los siguientes comandos como usuario con privilegios (o sudo):
- Asigna los permisos correctos a los directorios:
find var generated pub/static pub/media app/etc -type d -exec chmod 755 {} + - Asigna los permisos correctos a los archivos:
find var generated pub/static pub/media app/etc -type f -exec chmod 644 {} + - Asegúrate de que el usuario del servidor web (por ejemplo,
www-dataonginx) sea el propietario de los archivos:sudo chown -R www-data:www-data .