¿Qué es el error de indexación en Magento 2 y por qué ocurre?
Uno de los problemas más comunes a los que se enfrentan los administradores de tiendas online en Adobe Commerce (Magento 2) es el fallo en los indexadores. Magento utiliza un sistema de indexación para transformar los datos de la tienda —como precios, catálogos, categorías y reglas de descuento— en tablas estructuradas para mejorar la velocidad de carga. Cuando este proceso se detiene, queda en estado Processing o Invalid, los cambios recientes en el panel de administración no se reflejan en la tienda principal.
Las causas principales de este error suelen ser la falta de memoria RAM asignada a PHP, interrupciones durante la ejecución masiva de tareas mediante el Cron, o bloqueos en la base de datos MySQL debido a procesos colgados.
Método 1: Solucionar la indexación mediante la línea de comandos (CLI)
La forma más rápida y efectiva de reiniciar los indexadores bloqueados es utilizando la interfaz de comandos SSH de tu servidor. Sigue estos pasos:
- Accede a tu servidor mediante SSH utilizando tus credenciales de acceso.
- Navega hasta la raíz de tu instalación de Magento utilizando el comando
cd, por ejemplo:cd /var/www/html/tu-tienda-magento - Verifica el estado actual de los indexadores ejecutando el siguiente comando:
bin/magento indexer:infoobin/magento indexer:status - Si observas algún índice en estado
Invalid, fuerza una reindexación completa ejecutando:bin/magento indexer:reindex - Limpia la caché del sistema para asegurar que los cambios surtan efecto inmediatamente:
bin/magento cache:clean
Método 2: Matar procesos colgados y reparar tablas en la Base de Datos
Si el comando anterior se queda congelado o arroja un error de base de datos, es muy probable que existan bloqueos de tablas (tables locks) o procesos anteriores de PHP que no finalizaron correctamente.
- Accede a tu gestor de base de datos (phpMyAdmin o consola MySQL).
- Ejecuta una consulta para identificar procesos lentos o bloqueados:
SHOW PROCESSLIST; - Si encuentras consultas de Magento detenidas por demasiado tiempo, puedes finalizar el proceso utilizando:
KILL [ID_DEL_PROCESO]; - Optimiza y repara las tablas del indexador ejecutando en tu terminal SSH el comando de limpieza de triggers:
bin/magento setup:upgrade - Vuelve a intentar el proceso de reindexación con los límites de memoria de PHP ampliados:
php -d memory_limit=2G bin/magento indexer:reindex
Método 3: Configurar correctamente el Cron de Magento para evitar futuros bloqueos
Muchos de estos errores ocurren porque el sistema de tareas programadas (Cron) no está configurado de manera óptima en el servidor, haciendo que los índices se acumulen.
- Abre la configuración del cron del usuario del sistema web ejecutando:
crontab -e - Asegúrate de que las tareas cron de Magento se ejecuten cada 5 minutos añadiendo la siguiente línea:
* * * * * /usr/bin/php /ruta/a/tu/magento/bin/magento cron:runയെ - Guarda los cambios y verifica que el cron se esté ejecutando correctamente revisando los registros en la carpeta
var/log/de tu instalación.