Adobe Commerce에서 카탈로그 검색 색인 재지정에 실패했습니다.
Adobe Commerce에서 카탈로그 검색 리인덱싱이 실패하여 catalogsearch_fulltext 인덱서가 Reindex Required 또는 Staged 상태로 남습니다. 검색 결과가 최근 카탈로그 업데이트를 반영하지 않으며 인덱싱 작업이 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.같은 오류를 반환합니다. - 카탈로그 업데이트 후에는 검색 기능을 사용할 수 없습니다.
원인
OpenSearch 구성 문제, 인덱싱 잠금, cron 실패, OpenSearch 리소스 제약 조건 또는 확장 관련 오류로 인해 Adobe Commerce에서 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의 출력- 관련 예외 로그
- 리인덱싱하는 동안 정확한 오류 메시지가 반환됨
- 문제 해결 중에 이미 수행된 단계