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_fulltextne 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,oucircuit_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
-
Vérifiez le statut de l’indexeur de la recherche catalogue en exécutant
bin/magento indexer:statuset en examinant le statut descatalogsearch_fulltext. Si l’indexeur affiche Réindexation requise, continuez avec les étapes de dépannage restantes. -
Vérifiez qu’Adobe Commerce utilise
OpenSearchcomme moteur de recherche en exécutantbin/magento config:show catalog/search/engine. Vérifiez que la commande renvoieopensearch. -
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. -
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écutezbin/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.
-
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.
-
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.
-
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.
-
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.
-
Vérifiez si le message d’erreur affiche
circuit_breaking_exceptionou[parent]Données trop volumineuses.- Vérifiez tous les messages d’erreur liés à OpenSearch disponibles.
- Contactez l’assistance pour plus d’informations.
-
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.
-
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.
-
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