Dicas e Soluções

Busca Magento 2 sem resultados? Encontre a falha em 10 testes

Especialista investigando falha na busca Magento 2 em ambiente de servidores

Busca Magento 2 sem resultados? Encontre a falha em 10 testes

Busca Magento 2 sem resultados, produtos ausentes ou mensagens de erro durante a pesquisa podem reduzir a descoberta do catálogo e interromper jornadas de compra. Embora o OpenSearch costume aparecer como primeiro suspeito, a origem também pode estar na configuração da loja, na elegibilidade dos produtos, em indexadores, tarefas cron ou extensões de busca.

Antes de reindexar tudo ou reiniciar serviços, registre o termo pesquisado, a URL, a visão de loja, o horário e os produtos que deveriam aparecer. Os dez testes a seguir ajudam a localizar a camada responsável sem esconder as evidências.

Busca Magento 2 sem resultados: delimite o sintoma

Comece reproduzindo o problema em uma janela anônima e em mais de um dispositivo. Pesquise um SKU exato, uma palavra presente no nome de um produto e um termo mais amplo. Compare também diferentes sites, lojas e visões de loja, quando existirem.

Classifique o comportamento observado:

  • Nenhuma pesquisa funciona: investigue mecanismo de busca, conexão, índices e configuração global.
  • Apenas alguns produtos não aparecem: verifique status, visibilidade, site, estoque e atributos pesquisáveis.
  • Uma visão de loja apresenta falha: revise escopo, idioma, atributos e configurações específicas.
  • A busca retorna erro 500: preserve logs e trate a exceção da aplicação ou da infraestrutura.
  • Os resultados estão antigos: examine indexadores, cron e processamento após alterações no catálogo.

Se a pesquisa produz um erro de servidor, siga também o roteiro de diagnóstico do erro 500 no Magento 2 antes de limpar arquivos ou reiniciar todos os componentes.

1. Confirme se o produto pode aparecer na busca

Abra um produto que deveria ser encontrado e confira seu status, visibilidade, associação ao site e disponibilidade comercial. Um item habilitado pode continuar ausente se estiver vinculado ao site errado ou configurado apenas para aparecer no catálogo.

Analise também produtos simples associados a configuráveis. Dependendo da estrutura do catálogo, a página relevante para o cliente pode ser a do produto configurável, enquanto o SKU simples funciona apenas como variação. Compare um produto ausente com outro semelhante que apareça corretamente.

2. Teste o SKU e os atributos pesquisáveis

Pesquise o SKU completo e termos presentes no nome. Se o SKU funciona, mas uma característica comercial não, verifique a configuração do atributo correspondente no Admin. Ele precisa participar da pesquisa para influenciar os resultados.

Evite alterar simultaneamente peso de busca, tipo de correspondência e vários atributos. Faça uma mudança por vez em homologação, reindexe o índice de pesquisa e registre o efeito. Essa disciplina ajuda a separar uma falha técnica de uma configuração de relevância inadequada.

3. Compare sites, lojas e visões de loja

Em instalações com múltiplas lojas, o mesmo produto pode ter nomes, status e valores de atributos diferentes por escopo. Confirme no Admin qual visão de loja está selecionada antes de avaliar o cadastro.

Teste ainda o domínio e o código de loja corretos. Se apenas uma operação falhar, não trate o incidente imediatamente como indisponibilidade geral do OpenSearch. O problema pode estar restrito ao índice, à configuração ou aos dados daquele escopo.

4. Verifique o estado dos indexadores

No diretório da aplicação, execute uma consulta que não modifica dados:

php bin/magento indexer:status
php bin/magento indexer:show-mode

Observe especialmente o indexador catalogsearch_fulltext. Estados como inválido, em processamento por tempo excessivo ou com backlog merecem investigação. Consulte os logs e o histórico operacional antes de disparar várias reindexações concorrentes.

Quando houver janela aprovada e a causa estiver compreendida, uma reindexação direcionada é mais controlada do que processar todos os índices:

php bin/magento indexer:reindex catalogsearch_fulltext

Execute o comando com o usuário correto da aplicação e acompanhe consumo de CPU, memória e duração, sobretudo em catálogos grandes.

5. Descubra se o cron está mantendo o índice atualizado

Indexadores no modo agendado dependem do cron. Um comando manual bem-sucedido não prova que a rotina automática está saudável. Verifique se os processos são executados pelo usuário correto e procure jobs atrasados ou com erro.

Se alterações aparecem na busca somente após uma reindexação manual, use o diagnóstico de cron do Magento 2 que não funciona. Não apague indiscriminadamente registros de cron_schedule, pois eles ajudam a identificar horários, falhas e recorrência.

6. Confirme a configuração do mecanismo de busca

Revise host, porta, autenticação, prefixo de índice e tempo limite configurados para o ambiente. Compare a configuração efetiva com a documentação interna da infraestrutura, sem copiar senhas ou credenciais para chamados e canais públicos.

Erros comuns incluem apontar a produção para um serviço de homologação, reutilizar o mesmo prefixo em ambientes diferentes ou manter um hostname antigo depois de uma migração. Faça a validação a partir do servidor da aplicação, pois um serviço acessível em sua estação pode estar bloqueado para o PHP ou para a rede interna.

7. Consulte a saúde do OpenSearch sem alterar o cluster

Com autorização da equipe de infraestrutura, faça uma consulta somente de leitura ao endpoint interno:

curl -sS "http://HOST_INTERNO:9200/_cluster/health?pretty"

Adapte protocolo, host, porta e autenticação ao ambiente, evitando registrar segredos no histórico do terminal. A resposta ajuda a verificar se o cluster está acessível e se há fragmentos não alocados. Uma resposta saudável, entretanto, não garante que o índice esperado pelo Magento exista ou contenha dados atuais.

Também verifique latência, espaço em disco e eventos do serviço. Reiniciar o OpenSearch sem entender a causa pode interromper outras lojas ou aplicações que utilizem o mesmo cluster.

8. Examine logs do Magento, PHP e OpenSearch

Reproduza uma única pesquisa controlada e correlacione o horário com var/log/system.log, var/log/exception.log, logs do PHP e registros do OpenSearch. Procure mensagens de conexão recusada, autenticação, tempo esgotado, índice ausente, consulta inválida ou limite de recursos.

Não compartilhe arquivos completos sem revisão: URLs, dados de clientes, tokens e informações da infraestrutura podem estar presentes. Copie apenas o trecho necessário, mantendo algumas linhas anteriores e posteriores à exceção.

9. Isole extensões, tema e personalizações

Módulos de pesquisa, autocomplete, navegação em camadas e merchandising podem modificar consultas ou substituir componentes nativos. Verifique se a falha começou após deploy, atualização de extensão, mudança de tema ou importação de configuração.

Faça a comparação em homologação com o mesmo banco sanitizado e a mesma versão do código. Não desative módulos aleatoriamente em produção: algumas extensões possuem dependências, tabelas próprias e processos de instalação que exigem um plano de retorno.

10. Valide correção, relevância e impacto comercial

Depois da correção, não se limite a uma palavra. Monte uma amostra com SKU, nome completo, nome parcial, acento, plural, marca e termos sem correspondência. Confirme que produtos indisponíveis seguem a regra comercial da loja e que preços, imagens e links dos resultados estão corretos.

Teste ainda autocomplete, página de resultados, filtros, paginação e pesquisa em dispositivos móveis. Monitore tempo de resposta e erros após a implantação. Caso o Admin também esteja degradado, investigue separadamente com os testes para Admin Magento 2 lento, evitando atribuir toda a lentidão ao mecanismo de busca.

O que evitar durante o diagnóstico

  • Limpar todos os caches antes de registrar o erro e os horários.
  • Excluir índices diretamente no OpenSearch sem backup e plano de reconstrução.
  • Executar várias reindexações simultâneas em produção.
  • Alterar atributos, relevância, cron e infraestrutura ao mesmo tempo.
  • Compartilhar credenciais, arquivos de configuração ou logs sem sanitização.
  • Considerar o problema resolvido após testar somente um termo.

Perguntas frequentes

Por que a busca do Magento 2 não encontra um produto ativo?

O produto pode estar com visibilidade inadequada, fora do site pesquisado, indisponível conforme a regra de estoque ou com dados ainda não processados pelo índice de pesquisa. Compare seu cadastro com um item semelhante que aparece normalmente.

Posso reindexar somente a busca do Magento 2?

Sim. O comando php bin/magento indexer:reindex catalogsearch_fulltext processa o índice de pesquisa. Antes de executá-lo em produção, verifique o estado do indexador, o cron, os logs e a capacidade do ambiente.

OpenSearch saudável significa que a pesquisa está funcionando?

Não. O cluster pode responder normalmente enquanto o Magento utiliza configuração incorreta, índice desatualizado, prefixo inadequado ou consultas modificadas por uma extensão.

Limpar o cache corrige resultados antigos na pesquisa?

Nem sempre. O cache e o índice de pesquisa são camadas diferentes. Se o indexador ou o cron estiver com falha, limpar caches pode não atualizar os documentos enviados ao mecanismo de busca.

Conclusão

Quando a busca Magento 2 fica sem resultados, a investigação deve começar pelo alcance do sintoma e avançar por produto, escopo, atributos, indexadores, cron, OpenSearch e customizações. Essa sequência reduz mudanças desnecessárias e produz evidências para uma correção mais segura.

Se a pesquisa continua inconsistente ou a reindexação compromete a operação, uma análise coordenada entre aplicação e infraestrutura pode acelerar o diagnóstico. A equipe do SuporteMagento.com.br pode ajudar a revisar logs, configuração, índices e extensões com foco na estabilidade da loja.