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

다음 단계에 따라 문제를 해결하십시오

  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