Adobe Commerce中的目錄搜尋重新索引失敗

目錄搜尋重新索引在Adobe Commerce中失敗,導致catalogsearch_fulltext索引器處於「需要重新索引」或「已擱置」狀態。 搜尋結果未反映最近的目錄更新,且索引作業傳回OpenSearch相關錯誤。 若要修正此問題,請先驗證索引器狀態、確認OpenSearch設定,以及驗證cron工作,然後再重新執行目錄搜尋索引。

說明 description

環境

  • Adobe Commerce 2.4.x
  • 雲端基礎結構上的Adobe Commerce
  • OpenSearch

問題/症狀

  • 嘗試編制索引後,目錄搜尋仍處於​ 需要重新索引 ​狀態。
  • catalogsearch_fulltext索引子無法完成重新索引作業。
  • 搜尋結果未反映最近的目錄更新或仍然不完整。
  • 索引作業傳回錯誤,例如Index is locked by another process, Fail in child process,circuit_breaking_exception.
  • 目錄更新後,搜尋功能變得無法使用

原因

當Adobe Commerce由於OpenSearch設定問題、索引鎖定、cron失敗、OpenSearch資源限制或擴充功能相關錯誤而無法完成catalogsearch_fulltext索引程式時,目錄搜尋重新索引會失敗。

解決方法 resolution

請依照下列步驟解決問題

  1. 執行bin/magento indexer:status並檢閱catalogsearch_fulltext的狀態,以驗證目錄搜尋索引子的狀態。 如果索引子顯示​需要重新索引,請繼續進行其餘的疑難排解步驟。

  2. 執行bin/magento config:show catalog/search/engine以確認Adobe Commerce使用OpenSearch作為搜尋引擎。 驗證命令是否傳回opensearch.

  3. 使用bin/magento indexer:reindex catalogsearch_fulltext執行手動重新索引。 命令完成後,請確認storefront搜尋會傳回預期的結果。

  4. 如果目錄搜尋索引子持續停滯或繼續報告​需要重新索引,請重設該索引子。 執行bin/magento indexer:reset catalogsearch_fulltext,,然後重新執行bin/magento indexer:reindex catalogsearch_fulltext.

    注意:重設索引子只會在Adobe Commerce中重設其狀態。 它不會刪除OpenSearch索引或移除目錄資料。

  5. 執行bin/magento cron:run以驗證cron工作是否正確執行。 確認排定的索引程式是否成功執行,並完成擱置的索引工作。

  6. 如果重新索引仍然失敗,請檢閱確切的錯誤訊息。

    • 如果目錄搜尋仍保留在​ 需要重新索引 ​中,請驗證cron功能、執行手動重新索引,並視需要重設索引器。
  7. 檢查錯誤訊息是否顯示​索引已由其他處理序鎖定

    • 確認目前沒有索引程式正在執行。
    • 重設受影響的索引器。
    • 重試重新索引。
  8. 檢查錯誤訊息是否在子處理序​ 中顯示 ​失敗。

    • 檢閱例外狀況記錄檔。
    • 確認是否出現OpenSearch相關錯誤。
    • 此錯誤通常是一種症狀,而不是失敗的根本原因。
    • 如果問題仍然存在,請聯絡Adobe支援
  9. 檢查錯誤訊息是否顯示circuit_breaking_exception或​[]資料太大

    • 檢閱任何可用的OpenSearch相關錯誤訊息。
    • 請聯絡Adobe支援以進一步調查。
  10. 如果重新索引後搜尋結果仍然不完整:

    • 驗證搜尋引擎設定。
    • 驗證「目錄搜尋」索引子狀態。
    • 如有必要,請排清快取。
  11. 請勿刪除OpenSearch索引作為第一個疑難排解步驟。

    • Adobe Commerce可在重新索引作業期間重新建立搜尋索引。
    • 刪除索引並不能解決基礎問題,例如OpenSearch資源限制、OpenSearch健康問題、OpenSearch連線問題或索引作業失敗。
    • 如果根本原因與OpenSearch健康情況或基礎結構有關,則重建索引會因為相同的原因而失敗。
  12. 如果問題仍然存在,請聯絡Adobe支援

  • 目錄搜尋重新索引一致失敗。
  • 索引子在重設後仍會卡住。
  • 索引期間出現OpenSearch相關的錯誤。
  • 重新索引後,搜尋功能仍然無法使用。
  • 此問題與特定環境無關。
  • 使用上述疑難排解步驟無法識別根本原因。

包含下列資訊:

  • 來自bin/magento indexer:status的輸出
  • 來自bin/magento config:show catalog/search/engine的輸出
  • 相關例外狀況記錄檔
  • 重新索引期間傳回的確切錯誤訊息
  • 疑難排解期間已執行的步驟

相關閱讀

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