Cómo Solucionar el Error 'Re-index process is already running' en Magento 2 de Forma Definitiva

Introducción al Error de Indexación en Magento 2

Uno de los problemas más frustrantes para los administradores de e-commerce en Magento 2 es encontrarse con el mensaje Re-index process is already running al intentar actualizar los índices desde la línea de comandos o el panel de administración. Este bloqueo ocurre generalmente porque una tarea de indexación previa se quedó colgada, fue interrumpida bruscamente o un proceso en segundo plano sigue activo en la base de datos.

Principales Causas del Bloqueo de Índices

Para solucionar este problema de manera efectiva, es importante comprender por qué se origina:

• Una ejecución anterior del comando bin/magento indexer:reindex fue interrumpida por falta de memoria (Out of Memory) o límite de tiempo (Timeout).
• Quedaron registros huérfanos o bloqueos activos en las tablas de la base de datos encargadas de gestionar los estados de los indexadores.
• Existen procesos concurrentes intentando ejecutar la misma tarea de indexación al mismo tiempo mediante el sistema de cron de Magento.

Método 1: Comprobar y Matar Procesos Activos del Sistema

El primer paso consiste en verificar si realmente hay un proceso de PHP ejecutando la indexación en el servidor en este preciso momento.

1. Accede a tu servidor VPS o dedicado mediante SSH con permisos de usuario con privilegios o sudo.
2. Ejecuta el siguiente comando para listar los procesos activos relacionados con el indexador de Magento:
   ps aux | grep magento
3. Identifica los ID de proceso (PID) que correspondan a la tarea de indexación y detenlos de manera segura utilizando el comando:
   kill -9 [PID]

Método 2: Limpiar las Tablas de Estado en la Base de Datos

Si el sistema operativo no muestra ningún proceso activo pero Magento sigue reportando que el índice está en ejecución, el problema radica en banderas (flags) residuales en la base de datos.

1. Accede a tu gestor de base de datos (phpMyAdmin o directamente por consola MySQL/MariaDB).
2. Selecciona la base de datos correspondiente a tu tienda Magento 2.
3. Ejecuta las siguientes consultas SQL para limpiar el estado de bloqueo de las tablas de indexación:
   TRUNCATE TABLE indexer_state;
TRUNCATE TABLE mview_state;

Método 3: Restablecer los Índices y Limpiar la Caché

Una vez limpiadas las tablas de estado, es momento de reconstruir los índices desde cero para asegurar la integridad de los datos de tu catálogo, precios y stock.

1. Regresa a la terminal SSH y sitúate en la raíz de tu instalación de Magento.
2. Ejecuta el comando para invalidar los índices actuales:
   bin/magento indexer:reset
3. A continuación, fuerza el reindexado completo ejecutando:
   bin/magento indexer:reindex
4. Finalmente, limpia la caché de la aplicación para eliminar cualquier rastro del error:
   bin/magento cache:clean