DokumentationExperience Cloud KCS

Neuindizierung der Katalogsuche in Adobe Commerce schlägt fehl

Letzte Aktualisierung: 13. Juli 2026

Die Neuindizierung der Katalogsuche schlägt in Adobe Commerce fehl, sodass sich der catalogsearch_fulltext-Indexer in einem Status „Erforderlich“ oder „Angehalten“ befindet. Die Suchergebnisse spiegeln nicht die neuesten Katalogaktualisierungen wider, und Indizierungsvorgänge geben OpenSearch-bezogene Fehler zurück. Um dieses Problem zu beheben, überprüfen Sie den Indexerstatus, bestätigen Sie die OpenSearch-Konfiguration und validieren Sie Cron-Aufträge , bevor Sie den Katalogsuchindex erneut ausführen.

Beschreibung description

Umgebung

  • Adobe Commerce 2.4.x
  • Adobe Commerce auf Cloud-Infrastruktur
  • OpenSearch

Problem/Symptome

  • Die Katalogsuche verbleibt nach Indizierungsversuchen Neuindizierung erforderlich.
  • Der catalogsearch_fulltext-Indexer kann Neuindizierungsvorgänge nicht abschließen.
  • Suchergebnisse spiegeln keine aktuellen Katalogaktualisierungen wider oder sind unvollständig.
  • Indizierungsvorgänge geben Fehler zurück, wie Index is locked by another process, Fail in child process, oder circuit_breaking_exception.
  • Die Suchfunktion ist nach Katalogaktualisierungen nicht mehr verfügbar

Ursache

Die Neuindizierung der Katalogsuche schlägt fehl, wenn Adobe Commerce den catalogsearch_fulltext-Indizierungsprozess aufgrund von OpenSearch-Konfigurationsproblemen, Indizierungssperren, Cron-Fehlern, OpenSearch-Ressourceneinschränkungen oder erweiterungsbezogenen Fehlern nicht abschließen kann.

Lösung resolution

Führen Sie diese Schritte aus, um das Problem zu beheben

  1. Überprüfen Sie den Status des Katalogsuchindexers, indem Sie bin/magento indexer:status ausführen und den Status von catalogsearch_fulltext überprüfen. Wenn der Indexer Neuindizierung erforderlich“, fahren Sie mit den verbleibenden Schritten zur Fehlerbehebung fort.

  2. Stellen Sie sicher, dass Adobe Commerce OpenSearch als Suchmaschine verwendet, indem Sie bin/magento config:show catalog/search/engine ausführen. Überprüfen, ob der Befehl opensearch. zurückgibt

  3. Führen Sie mit bin/magento indexer:reindex catalogsearch_fulltext eine manuelle Neuindizierung durch. Überprüfen Sie nach Abschluss des Befehls, ob die Storefront-Suche die erwarteten Ergebnisse zurückgibt.

  4. Setzen Sie den Katalogsuchindex zurück, wenn er hängen bleibt oder weiterhin meldet Neuindizierung erforderlich. Führen Sie bin/magento indexer:reset catalogsearch_fulltext, aus und führen Sie bin/magento indexer:reindex catalogsearch_fulltext. erneut aus

    Hinweis: Zurücksetzen eines Indexers setzt nur seinen Status in Adobe Commerce zurück. OpenSearch-Indizes werden nicht gelöscht und Katalogdaten werden nicht entfernt.

  5. Stellen Sie sicher, dass Cron-Aufträge korrekt ausgeführt werden, indem Sie bin/magento cron:run ausführen. Vergewissern Sie sich, dass geplante Indizierungsprozesse erfolgreich ausgeführt und ausstehende Indizierungsaufgaben abgeschlossen werden.

  6. Überprüfen Sie die genaue Fehlermeldung, wenn die Neuindizierung weiterhin fehlschlägt.

    • Wenn die Katalogsuche in Neuindizierung erforderlich verbleibt, überprüfen Sie die Cron-Funktionalität, führen Sie eine manuelle Neuindizierung aus und setzen Sie den Indexer bei Bedarf zurück.

  7. Überprüfen Sie, ob die Fehlermeldung Index ist durch einen anderen Prozess gesperrt.

    • Stellen Sie sicher, dass derzeit kein Indizierungsprozess ausgeführt wird.
    • Setzen Sie den betroffenen Indexer zurück.
    • Neuindizierung wiederholen.

  8. Überprüfen Sie, ob die Fehlermeldung "im untergeordneten Prozess“.

    • Überprüfen Sie die Ausnahmenprotokolle.
    • Überprüfen Sie, ob OpenSearch-bezogene Fehler vorhanden sind.
    • Dieser Fehler ist in der Regel eher ein Symptom als die Grundursache des Fehlers.
    • Adobe-Support kontaktieren wenn das Problem weiterhin besteht.

  9. Überprüfen Sie, ob die Fehlermeldung circuit_breaking_exception oder [übergeordnete ] anzeigt: Daten zu groß.

    • Überprüfen Sie alle verfügbaren OpenSearch-bezogenen Fehlermeldungen.
    • Wenden Sie sich an den Adobe-, um weitere Informationen zu erhalten.

  10. Wenn Suchergebnisse nach der Neuindizierung unvollständig bleiben:

    • Überprüfen Sie die Suchmaschinenkonfiguration.
    • Überprüfen Sie den Status des Katalogsuchindexers.
    • Leeren Sie bei Bedarf Caches.

  11. Löschen Sie OpenSearch-Indizes nicht als ersten Schritt zur Fehlerbehebung.

    • Adobe Commerce kann Suchindizes während eines Neuindizierungsvorgangs neu erstellen.
    • Durch das Löschen von Indizes werden zugrunde liegende Probleme wie OpenSearch-Ressourcenbeschränkungen, OpenSearch-Konsistenzprobleme, OpenSearch-Konnektivitätsprobleme oder fehlgeschlagene Indizierungsvorgänge nicht behoben.
    • Wenn die Grundursache mit der OpenSearch-Integrität oder -Infrastruktur zusammenhängt, schlägt die Neuerstellung von Indizes aus demselben Grund fehl.

  12. Adobe-Support kontaktieren wenn das Problem weiterhin besteht.

  • Die Neuindizierung der Katalogsuche schlägt konsequent fehl.
  • Der Indexer bleibt nach dem Zurücksetzen hängen.
  • OpenSearch-bezogene Fehler treten während der Indizierung auf.
  • Die Suchfunktion ist nach der Neuindizierung weiterhin nicht verfügbar.
  • Das Problem ist auf eine bestimmte Umgebung beschränkt.
  • Die Grundursache kann mithilfe der oben genannten Schritte zur Fehlerbehebung nicht identifiziert werden.

Fügen Sie die folgenden Informationen hinzu:

  • Ausgabe aus bin/magento indexer:status
  • Ausgabe aus bin/magento config:show catalog/search/engine
  • Relevante Ausnahmeprotokolle
  • Die genaue Fehlermeldung, die während der Neuindizierung zurückgegeben wurde
  • Bereits während der Fehlerbehebung ausgeführte Schritte

Verwandtes Lesen

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