El reíndice de búsqueda en el catálogo falla en Adobe Commerce

La reindexación de la búsqueda en el catálogo falla en Adobe Commerce y deja el indizador catalogsearch_fulltext en un estado Reindex Required o stalled. Los resultados de la búsqueda no reflejan las actualizaciones recientes del catálogo y las operaciones de indexación devuelven errores relacionados con OpenSearch. Para solucionar este problema, compruebe el estado del indexador, confirme la configuración de OpenSearch y valide los trabajos cron antes de volver a ejecutar el índice de búsqueda en el catálogo.

Descripción description

Entorno

  • Adobe Commerce 2.4.x
  • Adobe Commerce en infraestructura en la nube
  • OpenSearch

Problema/Síntomas

  • La búsqueda en el catálogo permanece en un estado Reindex obligatorio después de los intentos de indexación.
  • El indizador catalogsearch_fulltext no puede completar las operaciones de reindexación.
  • Los resultados de la búsqueda no reflejan las actualizaciones recientes del catálogo o permanecen incompletos.
  • Las operaciones de indización devuelven errores como Index is locked by another process, Fail in child process, o circuit_breaking_exception.
  • La funcionalidad de búsqueda no está disponible después de las actualizaciones del catálogo

Causa

La reindexación de la búsqueda en el catálogo falla cuando Adobe Commerce no puede completar el proceso de indexación catalogsearch_fulltext debido a problemas de configuración de OpenSearch, bloqueos de indexación, errores cron, restricciones de recursos de OpenSearch o errores relacionados con la extensión.

Resolución resolution

Siga estos pasos para resolver el problema

  1. Compruebe el estado del indizador Búsqueda en el catálogo ejecutando bin/magento indexer:status y revisando el estado de catalogsearch_fulltext. Si el indizador muestra Reindexación requerida, continúe con los pasos restantes para solucionar problemas.

  2. Confirme que Adobe Commerce usa OpenSearch como motor de búsqueda al ejecutar bin/magento config:show catalog/search/engine. Compruebe que el comando devuelve opensearch.

  3. Ejecute un reíndice manual mediante bin/magento indexer:reindex catalogsearch_fulltext. Una vez finalizado el comando, comprueba que la búsqueda en tienda devuelve los resultados esperados.

  4. Restablezca el indizador de búsqueda en el catálogo si permanece atascado o continúa informando de Reindexación requerida. Ejecutar bin/magento indexer:reset catalogsearch_fulltext, y volver a ejecutar bin/magento indexer:reindex catalogsearch_fulltext.

    Nota: El restablecimiento de un indizador solo restablece su estado en Adobe Commerce. No elimina los índices de OpenSearch ni los datos del catálogo.

  5. Compruebe que los trabajos cron se ejecutan correctamente ejecutando bin/magento cron:run. Confirme que los procesos de indexación programados se ejecutan correctamente y completan las tareas de indexación pendientes.

  6. Revise el mensaje de error exacto si la reindexación sigue fallando.

    • Si la búsqueda en el catálogo permanece en Reindex requerido, compruebe la funcionalidad cron, ejecute un reíndice manual y restablezca el indizador si es necesario.
  7. Compruebe si el mensaje de error muestra El índice está bloqueado por otro proceso.

    • Compruebe que no hay ningún proceso de indexación en ejecución.
    • Restablezca el indizador afectado.
    • Vuelva a intentar la reindexación.
  8. Compruebe si el mensaje de error muestra Error en el proceso secundario.

    • Revise los registros de excepciones.
    • Compruebe si hay errores relacionados con OpenSearch.
    • Este error suele ser un síntoma más que la causa principal del error.
    • Póngase en contacto con el Soporte técnico de Adobe si el problema persiste.
  9. Compruebe si el mensaje de error muestra circuit_breaking_exception o [datos principales] demasiado grandes.

    • Revise los mensajes de error disponibles relacionados con OpenSearch.
    • Póngase en contacto con el Soporte técnico de Adobe para obtener más información.
  10. Si los resultados de la búsqueda permanecen incompletos después de la reindexación:

    • Compruebe la configuración del motor de búsqueda.
    • Compruebe el estado del indexador Búsqueda en el catálogo.
    • Vacíe las cachés si es necesario.
  11. No elimine los índices de OpenSearch como primer paso para solucionar problemas.

    • Adobe Commerce puede volver a crear índices de búsqueda durante una operación de reindexación.
    • La eliminación de índices no resuelve los problemas subyacentes, como las restricciones de recursos de OpenSearch, los problemas de estado de OpenSearch, los problemas de conectividad de OpenSearch o las operaciones de indexación fallidas.
    • Si la causa raíz está relacionada con el estado o la infraestructura de OpenSearch, la reconstrucción de índices falla por la misma razón.
  12. Póngase en contacto con el Soporte técnico de Adobesi el problema persiste.

  • La reindexación de la búsqueda en catálogo falla de forma consistente.
  • El indizador permanece atascado después de restablecerse.
  • Los errores relacionados con OpenSearch aparecen durante la indexación.
  • La funcionalidad de búsqueda permanece no disponible después de la reindexación.
  • El problema está aislado en un entorno específico.
  • La causa raíz no se puede identificar mediante los pasos de solución de problemas anteriores.

Incluya la siguiente información:

  • Salida de bin/magento indexer:status
  • Salida de bin/magento config:show catalog/search/engine
  • Registros de excepciones relevantes
  • El mensaje de error exacto devuelto durante la reindexación
  • Pasos ya realizados durante la resolución de problemas

Lectura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles