La réindexation de la recherche catalogue échoue dans Adobe Commerce

La réindexation de la recherche catalogue échoue dans Adobe Commerce, laissant le moteur d’indexation catalogsearch_fulltext dans un statut Réindexation obligatoire ou bloqué. Les résultats de recherche ne reflètent pas les mises à jour récentes du catalogue, et les opérations d’indexation renvoient des erreurs liées à OpenSearch. Pour résoudre ce problème, vérifiez le statut de l’indexeur, confirmez la configuration OpenSearch et validez les tâches cron avant de réexécuter l’index de recherche catalogue.

Description description

Environnement

  • Adobe Commerce 2.4.x
  • Adobe Commerce sur les infrastructures cloud
  • OpenSearch

Problème/Symptômes

  • La recherche catalogue conserve l’état Réindexation requise après les tentatives d’indexation.
  • L’indexeur de catalogsearch_fulltext ne parvient pas à terminer les opérations de réindexation.
  • Les résultats de la recherche ne reflètent pas les mises à jour récentes du catalogue ou restent incomplets.
  • Les opérations d’indexation renvoient des erreurs telles que Index is locked by another process, Fail in child process, ou circuit_breaking_exception.
  • La fonctionnalité de recherche devient indisponible après les mises à jour du catalogue

Cause

La réindexation de la recherche catalogue échoue lorsqu’Adobe Commerce ne peut pas terminer le processus d’indexation catalogsearch_fulltext en raison de problèmes de configuration d’OpenSearch, de verrous d’indexation, d’échecs cron, de contraintes de ressources OpenSearch ou d’erreurs liées à l’extension.

Résolution resolution

Pour résoudre ce problème, procédez comme suit

  1. Vérifiez le statut de l’indexeur de la recherche catalogue en exécutant bin/magento indexer:status et en examinant le statut des catalogsearch_fulltext. Si l’indexeur affiche Réindexation requise, continuez avec les étapes de dépannage restantes.

  2. Vérifiez qu’Adobe Commerce utilise OpenSearch comme moteur de recherche en exécutant bin/magento config:show catalog/search/engine. Vérifiez que la commande renvoie opensearch.

  3. Exécutez une réindexation manuelle à l’aide de bin/magento indexer:reindex catalogsearch_fulltext. Une fois la commande terminée, vérifiez que la recherche storefront renvoie les résultats attendus.

  4. Réinitialisez l’indexeur de la recherche catalogue s’il reste bloqué ou continue de signaler Réindexation requise. Exécutez bin/magento indexer:reset catalogsearch_fulltext, puis réexécutez bin/magento indexer:reindex catalogsearch_fulltext.

    Remarque : la réinitialisation d’un indexeur ne réinitialise son statut que dans Adobe Commerce. Il ne supprime pas les index OpenSearch ni les données de catalogue.

  5. Vérifiez que les tâches cron s’exécutent correctement en exécutant bin/magento cron:run. Vérifiez que les processus d’indexation planifiés s’exécutent correctement et terminent les tâches d’indexation en attente.

  6. Consultez le message d’erreur exact si la réindexation échoue toujours.

    • Si la recherche catalogue reste dans Réindexation requise, vérifiez la fonctionnalité cron, exécutez une réindexation manuelle et réinitialisez l’indexeur si nécessaire.
  7. Vérifiez si le message d’erreur indique L’index est verrouillé par un autre processus.

    • Vérifiez qu’aucun processus d’indexation n’est en cours d’exécution.
    • Réinitialisez l’indexeur concerné.
    • Réessayez la réindexation.
  8. Vérifiez que le message d’erreur indique Échec dans le processus enfant.

    • Consultez les journaux des exceptions.
    • Vérifiez si des erreurs liées à OpenSearch sont présentes.
    • Cette erreur est généralement un symptôme plutôt que la cause première de l’échec.
    • Contactez l’assistance ​ si le problème persiste.
  9. Vérifiez si le message d’erreur affiche circuit_breaking_exception ou [parent] Données trop volumineuses.

    • Vérifiez tous les messages d’erreur liés à OpenSearch disponibles.
    • Contactez l’assistance ​ pour plus d’informations.
  10. Si les résultats de la recherche restent incomplets après la réindexation :

    • Vérifiez la configuration du moteur de recherche.
    • Vérifiez le statut de l’indexeur de la recherche catalogue .
    • Videz les caches si nécessaire.
  11. Ne supprimez pas les index OpenSearch comme première étape de dépannage.

    • Adobe Commerce peut recréer des index de recherche au cours d’une opération de réindexation.
    • La suppression des index ne résout pas les problèmes sous-jacents tels que les contraintes de ressources OpenSearch, les problèmes d’intégrité OpenSearch, les problèmes de connectivité OpenSearch ou les échecs des opérations d’indexation.
    • Si la cause première est liée à l’intégrité ou à l’infrastructure d’OpenSearch, la reconstruction des index échoue pour la même raison.
  12. Contactez l’assistance ​si le problème persiste.

  • La réindexation de la recherche catalogue échoue systématiquement.
  • L’indexeur reste bloqué après avoir été réinitialisé.
  • Les erreurs liées à OpenSearch apparaissent lors de l’indexation.
  • La fonctionnalité de recherche reste indisponible après la réindexation.
  • Le problème est isolé dans un environnement spécifique.
  • La cause première ne peut pas être identifiée à l’aide des étapes de dépannage ci-dessus.

Insérez les informations suivantes :

  • Sortie de bin/magento indexer:status
  • Sortie de bin/magento config:show catalog/search/engine
  • Logs des exceptions pertinents
  • Message d’erreur exact renvoyé lors de la réindexation
  • Étapes déjà effectuées lors du dépannage

Lecture connexe

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