¿Qué es el error Re-index Required en Magento y por qué ocurre?
En el ecosistema de Magento 2, el sistema de indexación transforma los datos de la tienda (como precios, categorías, catálogos y reglas de descuento) para mejorar significativamente el rendimiento del frontend. Cuando realizas cambios masivos de productos, importaciones o actualizaciones de módulos, el sistema marca ciertas tablas como obsoletas, mostrando el aviso One or more indexers are invalid or out of date.
Las causas principales de este problema incluyen interrupciones en tareas programadas (cron jobs), falta de memoria RAM asignada a PHP durante la ejecución de procesos largos, o conflictos de concurrencia al actualizar la base de datos simultáneamente.
Método 1: Solucionar la indexación mediante la Línea de Comandos (CLI)
La forma más rápida y efectiva de corregir este inconveniente es utilizando la consola SSH de tu servidor mediante el CLI de Magento.
- Accede a tu servidor mediante SSH utilizando tus credenciales de acceso.
- Navega hasta la raíz de tu instalación de Magento (por ejemplo,
cd /var/www/html/tu-tienda-magento). - Ejecuta el siguiente comando para verificar el estado actual de los indexadores:
bin/magento indexer:info - Para forzar la actualización de todos los índices pendientes, ejecuta el comando de reindexación completa:
bin/magento indexer:reindex - Limpia la caché de la aplicación para asegurar que los cambios se reflejen inmediatamente:
bin/magento cache:clean
Método 2: Cambiar el modo de indexación a Schedule
Si el problema ocurre constantemente debido a la gran cantidad de transacciones o catálogos extensos, configurar el indexador en modo por lotes (cron) evitará bloqueos en tiempo real.
- Accede a la terminal SSH de tu servidor en el directorio raíz de Magento.
- Ejecuta el comando para configurar todos los indexadores en modo programado:
bin/magento indexer:set-mode schedule - Asegúrate de que el sistema de tareas cron de tu servidor esté configurado y ejecutándose correctamente añadiendo la tarea al crontab del usuario del sistema:
php bin/magento cron:run
Método 3: Liberar tablas bloqueadas en la Base de Datos
En ocasiones, un proceso de indexación interrumpido deja bloqueadas las tablas con estados de bloqueo temporal, impidiendo cualquier nueva ejecución.
- Inicia sesión en tu gestor de base de datos (como phpMyAdmin o consola MySQL).
- Selecciona la base de datos de tu tienda Magento.
- Identifica y elimina los registros de bloqueo ejecutando las siguientes consultas SQL:
TRUNCATE TABLE indexer_state; - Vuelve a tu terminal SSH y ejecuta el comando de reindexación manual para reconstruir los estados:
bin/magento indexer:reindex