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
請依照下列步驟解決問題
-
執行
bin/magento indexer:status並檢閱catalogsearch_fulltext的狀態,以驗證目錄搜尋索引子的狀態。 如果索引子顯示需要重新索引,請繼續進行其餘的疑難排解步驟。 -
執行
bin/magento config:show catalog/search/engine以確認Adobe Commerce使用OpenSearch作為搜尋引擎。 驗證命令是否傳回opensearch. -
使用
bin/magento indexer:reindex catalogsearch_fulltext執行手動重新索引。 命令完成後,請確認storefront搜尋會傳回預期的結果。 -
如果目錄搜尋索引子持續停滯或繼續報告需要重新索引,請重設該索引子。 執行
bin/magento indexer:reset catalogsearch_fulltext,,然後重新執行bin/magento indexer:reindex catalogsearch_fulltext.注意:重設索引子只會在Adobe Commerce中重設其狀態。 它不會刪除OpenSearch索引或移除目錄資料。
-
執行bin/magento cron:run以驗證cron工作是否正確執行。 確認排定的索引程式是否成功執行,並完成擱置的索引工作。
-
如果重新索引仍然失敗,請檢閱確切的錯誤訊息。
- 如果目錄搜尋仍保留在 需要重新索引 中,請驗證cron功能、執行手動重新索引,並視需要重設索引器。
-
檢查錯誤訊息是否顯示索引已由其他處理序鎖定。
- 確認目前沒有索引程式正在執行。
- 重設受影響的索引器。
- 重試重新索引。
-
檢查錯誤訊息是否在子處理序 中顯示 失敗。
- 檢閱例外狀況記錄檔。
- 確認是否出現OpenSearch相關錯誤。
- 此錯誤通常是一種症狀,而不是失敗的根本原因。
- 如果問題仍然存在,請聯絡Adobe支援。
-
檢查錯誤訊息是否顯示
circuit_breaking_exception或[父]資料太大。- 檢閱任何可用的OpenSearch相關錯誤訊息。
- 請聯絡Adobe支援以進一步調查。
-
如果重新索引後搜尋結果仍然不完整:
- 驗證搜尋引擎設定。
- 驗證「目錄搜尋」索引子狀態。
- 如有必要,請排清快取。
-
請勿刪除OpenSearch索引作為第一個疑難排解步驟。
- Adobe Commerce可在重新索引作業期間重新建立搜尋索引。
- 刪除索引並不能解決基礎問題,例如OpenSearch資源限制、OpenSearch健康問題、OpenSearch連線問題或索引作業失敗。
- 如果根本原因與OpenSearch健康情況或基礎結構有關,則重建索引會因為相同的原因而失敗。
-
如果問題仍然存在,請聯絡Adobe支援。
- 目錄搜尋重新索引一致失敗。
- 索引子在重設後仍會卡住。
- 索引期間出現OpenSearch相關的錯誤。
- 重新索引後,搜尋功能仍然無法使用。
- 此問題與特定環境無關。
- 使用上述疑難排解步驟無法識別根本原因。
包含下列資訊:
- 來自
bin/magento indexer:status的輸出 - 來自
bin/magento config:show catalog/search/engine的輸出 - 相關例外狀況記錄檔
- 重新索引期間傳回的確切錯誤訊息
- 疑難排解期間已執行的步驟
相關閱讀
- 管理索引子
- 設定OpenSearch
- 搜尋引擎概觀
- Adobe Commerce Cloud上的OpenSearch服務
- 索引被另一個處理序鎖定