DocumentaçãoKCS da Experience Cloud

A reindexação da Pesquisa no catálogo falha no Adobe Commerce

Última atualização: 13 de julho de 2026

A reindexação da Pesquisa no Catálogo falha no Adobe Commerce, deixando o indexador catalogsearch_fulltext em um estado Reindexação necessária ou paralisado. Os resultados da pesquisa não refletem as atualizações recentes do catálogo e as operações de indexação retornam erros relacionados ao OpenSearch. Para corrigir esse problema, verifique o status do indexador, confirme a configuração OpenSearch e valide os trabalhos cron antes de executar novamente o índice da Pesquisa no catálogo.

Descrição description

Ambiente

  • Adobe Commerce 2.4.x
  • Adobe Commerce na infraestrutura em nuvem
  • OpenSearch

Problema/Sintomas

  • A Pesquisa no Catálogo permanece em um estado Reindexação necessária após tentativas de indexação.
  • Falha do indexador catalogsearch_fulltext ao concluir operações de reindexação.
  • Os resultados da pesquisa não refletem atualizações recentes no catálogo ou permanecem incompletos.
  • As operações de indexação retornam erros como Index is locked by another process, Fail in child process, ou circuit_breaking_exception.
  • A funcionalidade de pesquisa fica indisponível após as atualizações do catálogo

Causa

A reindexação da Pesquisa no Catálogo falha quando o Adobe Commerce não pode concluir o processo de indexação do catalogsearch_fulltext devido a problemas de configuração do OpenSearch, bloqueios de indexação, falhas de cron, restrições de recursos do OpenSearch ou erros relacionados à extensão.

Resolução resolution

Siga estas etapas para resolver o problema

  1. Verifique o status do indexador da Pesquisa no Catálogo executando bin/magento indexer:status e revisando o status de catalogsearch_fulltext. Se o indexador mostrar Reindexação necessária, continue com as etapas de solução de problemas restantes.

  2. Confirme se o Adobe Commerce usa OpenSearch como mecanismo de pesquisa executando bin/magento config:show catalog/search/engine. Verifique se o comando retorna opensearch.

  3. Executar uma reindexação manual usando bin/magento indexer:reindex catalogsearch_fulltext. Depois que o comando for concluído, verifique se a pesquisa da loja retorna os resultados esperados.

  4. Redefina o indexador da Pesquisa de Catálogo se ele permanecer preso ou continuar a relatar Reindexação necessária. Executar bin/magento indexer:reset catalogsearch_fulltext, e executar novamente bin/magento indexer:reindex catalogsearch_fulltext.

    Observação: a redefinição de um indexador apenas redefine seu status dentro do Adobe Commerce. Isso não exclui índices OpenSearch ou remove dados de catálogo.

  5. Verifique se os trabalhos cron são executados corretamente executando bin/magento cron:run. Confirme se os processos de indexação programados foram executados com sucesso e conclua as tarefas de indexação pendentes.

  6. Revise a mensagem de erro exata se a reindexação ainda falhar.

    • Se a Pesquisa no Catálogo permanecer em Reindexação necessária, verifique a funcionalidade cron, execute uma reindexação manual e redefina o indexador, se necessário.

  7. Verifique se a mensagem de erro mostra que o Índice está bloqueado por outro processo.

    • Verifique se nenhum processo de indexação está em execução no momento.
    • Reinicializa o indexador afetado.
    • Tente reindexar novamente.

  8. Verifique se a mensagem de erro mostra Falha no processo filho.

    • Revise os logs de exceção.
    • Verifique se há erros relacionados ao OpenSearch.
    • Normalmente, esse erro é um sintoma, e não a causa principal da falha.
    • Contate o Suporte da Adobe se o problema persistir.

  9. Verifique se a mensagem de erro mostra dados circuit_breaking_exception ou [pai] muito grandes.

    • Revise todas as mensagens de erro relacionadas ao OpenSearch disponíveis.
    • Entre em contato com o Suporte da Adobe para obter mais detalhes.

  10. Se os resultados da pesquisa permanecerem incompletos após a reindexação:

    • Verifique a configuração do mecanismo de pesquisa.
    • Verifique o status do indexador da Pesquisa no catálogo.
    • Liberar caches, se necessário.

  11. Não exclua índices OpenSearch como a primeira etapa da solução de problemas.

    • O Adobe Commerce pode recriar índices de pesquisa durante uma operação de reindexação.
    • A exclusão de índices não resolve problemas subjacentes, como restrições de recursos do OpenSearch, problemas de integridade do OpenSearch, problemas de conectividade do OpenSearch ou operações de indexação com falha.
    • Se a causa raiz estiver relacionada à integridade ou à infraestrutura do OpenSearch, a recriação de índices falhará pelo mesmo motivo.

  12. Contate o Suporte da Adobese o problema continuar.

  • A reindexação da Pesquisa no catálogo falha consistentemente.
  • O indexador permanece preso após ser redefinido.
  • Erros relacionados ao OpenSearch aparecem durante a indexação.
  • A funcionalidade de pesquisa permanece indisponível após a reindexação.
  • O problema é isolado a um ambiente específico.
  • A causa raiz não pode ser identificada usando as etapas de solução de problemas acima.

Inclua as seguintes informações:

  • Saída de bin/magento indexer:status
  • Saída de bin/magento config:show catalog/search/engine
  • Logs de exceção relevantes
  • A mensagem de erro exata retornada durante a reindexação
  • Etapas já executadas durante a solução de problemas

Leitura relacionada

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