Produto não aparece no Magento 2? Checklist para corrigir sem reindexar tudo

Produto não aparece no Magento 2 mesmo estando cadastrado no painel? O problema pode surgir após uma importação, alteração de estoque, atualização em massa, deploy ou falha no cron. Em vez de reindexar toda a loja imediatamente, o caminho mais seguro é descobrir em qual etapa o produto deixou de ficar disponível.

Status, vínculo com o website, visibilidade, estoque, indexadores, cache e mecanismo de busca participam desse processo. O checklist abaixo ajuda a localizar a causa sem transformar uma inconsistência isolada em uma manutenção arriscada para todo o catálogo.

Por que um produto cadastrado não aparece na loja?

O cadastro salvo no painel é apenas uma parte da publicação. Para aparecer no catálogo, o produto precisa estar habilitado, associado ao website correto e disponível dentro do contexto da loja acessada. Dependendo da configuração, também precisa atender às regras de estoque e ter seus dados processados pelos indexadores.

Os sintomas mais comuns incluem:

• o produto abre por URL direta, mas não aparece na categoria;
• aparece na categoria, mas não é localizado pela busca;
• fica visível em uma store view e desaparece em outra;
• o produto simples não aparece, mas integra um configurável;
• o painel mostra estoque disponível, enquanto a vitrine informa indisponibilidade;
• alterações recentes aparecem no Admin, mas não chegam ao frontend.

Essas diferenças ajudam a separar um problema de cadastro de uma falha de indexação, cache, busca ou escopo.

Produto não aparece no Magento 2: o que verificar primeiro

1. Confirme status, visibilidade e website

Abra o produto no painel e confira se o campo de status está habilitado. Depois, verifique a visibilidade. Um item configurado como não visível individualmente não deve aparecer sozinho em categorias ou resultados de pesquisa. Essa opção é comum em produtos simples associados a configuráveis.

Confira também a seção de websites. O produto pode estar habilitado e com estoque, mas associado a outro website da instalação. Em operações com várias lojas, valide o escopo selecionado no painel antes de alterar qualquer atributo.

Se o item deveria aparecer em uma categoria, confirme se ele realmente está vinculado a ela e se a categoria está habilitada no store view correspondente. Uma categoria fora do menu ainda pode ser acessível, mas configurações de inclusão e ancoragem influenciam a navegação e os filtros.

2. Revise o estoque e a fonte de inventário

Não observe somente a quantidade exibida no cadastro. Instalações que usam múltiplas fontes de inventário podem ter saldo em uma source que não está ligada ao stock usado pelo canal de vendas. Nesse cenário, existe quantidade registrada, mas ela não está disponível para o website correto.

Verifique:

• quantidade por fonte;
• status do item na fonte;
• relação entre source, stock e website;
• quantidade vendável;
• pedidos ou reservas que possam consumir o saldo disponível;
• configuração global e individual para exibir produtos sem estoque.

Em produtos configuráveis, revise também os filhos. O produto pai pode estar habilitado, mas ficar sem opções compráveis quando todos os simples estão desabilitados, indisponíveis ou sem os atributos necessários.

3. Compare o comportamento por URL, categoria e busca

Faça três testes separados: abra a URL direta do produto, procure-o na categoria e pesquise pelo nome ou SKU. O resultado indica quais camadas devem ser investigadas.

• Abre pela URL, mas não aparece na categoria: revise associação à categoria, regras de catálogo e índices relacionados aos produtos por categoria.
• Abre na categoria, mas não aparece na busca: investigue o índice de pesquisa e a comunicação com o OpenSearch ou mecanismo configurado.
• Não abre nem pela URL: confirme status, website, URL rewrite, escopo e possíveis erros da aplicação.

Se a falha estiver restrita à pesquisa, consulte também o diagnóstico sobre quando a busca do Magento não funciona. Reindexar o catálogo não corrige um serviço de busca inacessível ou incompatível.

Como verificar os indexadores do Magento

No diretório raiz do projeto, execute o comando abaixo com o mesmo usuário utilizado nas rotinas de manutenção da aplicação:

bin/magento indexer:status

O resultado pode indicar índices atualizados, inválidos, em processamento ou suspensos. Um índice inválido significa que existem dados que ainda precisam ser processados. Já um indexador preso em processamento pode apontar para execução interrompida, concorrência ou falha na rotina agendada.

Antes de reindexar, liste os identificadores disponíveis:

bin/magento indexer:info

Quando a causa estiver delimitada, prefira processar somente o índice relacionado. Por exemplo:

bin/magento indexer:reindex catalog_category_product
bin/magento indexer:reindex catalogsearch_fulltext

O primeiro atua na relação entre categorias e produtos. O segundo reconstrói os dados usados pela pesquisa. Os identificadores podem variar conforme módulos instalados, por isso devem ser confirmados com indexer:info.

Em catálogos grandes, uma reindexação completa pode consumir CPU, memória, banco de dados e mecanismo de busca. Execute-a em uma janela controlada e monitore o ambiente. Se a inconsistência começou após um patch, confirme a aplicabilidade e os efeitos da correção antes de alterá-la; o artigo sobre o Quality Patches Tool e indexadores explica como abordar patches específicos.

O papel do cron na atualização do catálogo

Quando os indexadores estão configurados para atualização por agendamento, salvar o produto não significa que a vitrine será atualizada imediatamente. O cron precisa executar as tarefas pendentes. Se ele estiver parado, o painel continua aceitando alterações enquanto índices, regras de preço, e-mails e outras rotinas se acumulam.

Consulte a configuração dos indexadores:

bin/magento indexer:show-mode

Se o índice estiver no modo de atualização por agendamento, confira se os processos do cron estão sendo executados pelo usuário correto e se existem erros nos logs do sistema. Também é útil observar a tabela de agendamentos para identificar tarefas atrasadas ou com falha, sem apagar registros indiscriminadamente.

Executar manualmente o cron uma vez pode ajudar no diagnóstico:

bin/magento cron:run

Esse comando não substitui a configuração permanente do agendador no servidor. Se o problema reaparecer, será necessário corrigir a origem: entrada ausente no crontab, permissões, usuário incorreto, processos sobrepostos ou falhas recorrentes em algum grupo de tarefas.

Cache pode esconder um produto atualizado?

Sim, mas o cache não deve ser a primeira explicação para todo produto ausente. Verifique o estado dos tipos de cache:

bin/magento cache:status

Depois de confirmar cadastro, estoque e índices, faça uma limpeza direcionada quando possível. Evite usar indiscriminadamente comandos que removam todos os dados do armazenamento de cache, especialmente quando Redis é compartilhado com sessões ou outras aplicações.

Também considere camadas externas, como proxy reverso, CDN e cache do navegador. Um teste em janela anônima, com URL que não esteja previamente armazenada, ajuda a comparar respostas. Se o produto aparece em um nó e desaparece em outro, investigue sincronização de código, arquivos gerados, configuração e serviços entre os servidores.

Quando consultar logs e transformar o caso em incidente

Se o reindex falhar, não repita o comando indefinidamente. Registre o horário e consulte var/log/system.log, var/log/exception.log e os registros do PHP, banco de dados e mecanismo de busca. Falta de memória, bloqueios no banco, documentos rejeitados e falhas de conexão costumam deixar evidências nesses locais.

Caso o produto ou a categoria retorne uma falha do servidor, siga um diagnóstico específico de erro 500 no Magento 2 antes de alterar módulos ou permissões.

Trate o problema como incidente quando muitos produtos desaparecem ao mesmo tempo, a busca deixa de responder, o cron acumula falhas ou a reindexação afeta a disponibilidade da loja. Nessa situação, preserve logs, registre as últimas mudanças e evite várias intervenções simultâneas.

Checklist final de correção

1. confirme status, visibilidade, website e store view;
2. revise categoria, URL e regras de catálogo;
3. valide fontes, stocks, reservas e quantidade vendável;
4. teste separadamente URL direta, categoria e pesquisa;
5. consulte o estado e o modo dos indexadores;
6. verifique cron e tarefas com erro;
7. reindexe apenas o componente relacionado ao sintoma;
8. limpe o cache de forma controlada;
9. analise logs se o processamento falhar;
10. teste novamente como cliente, no website e store view corretos.

Conclusão

Quando um produto não aparece no Magento 2, reindexar tudo pode mascarar a causa e aumentar a carga do ambiente. A investigação deve começar pelo escopo do cadastro e seguir por estoque, categoria, busca, indexadores, cron e cache.

Se vários itens desapareceram, os índices continuam presos ou o problema retorna após cada atualização, uma análise técnica do ambiente pode evitar novas interrupções. A equipe do SuporteMagento.com.br pode ajudar a diagnosticar catálogo, cron, busca e infraestrutura com foco na origem da falha.

Perguntas frequentes

Por que o produto está habilitado no Magento, mas não aparece?

Ele pode estar fora do website correto, com visibilidade inadequada, sem estoque vendável, sem associação à categoria ou aguardando processamento dos indexadores. Compare a URL direta, a categoria e a busca para delimitar a causa.

Preciso reindexar tudo quando um produto não aparece?

Não necessariamente. Verifique primeiro o status dos indexadores e identifique qual camada está desatualizada. Quando necessário, prefira reindexar somente o índice relacionado, reduzindo o impacto sobre a infraestrutura.

Limpar o cache faz o produto voltar para a loja?

Pode resolver uma resposta armazenada, mas não corrige cadastro, estoque, cron ou índice com falha. A limpeza deve ser realizada depois dessas verificações e de maneira controlada.

Um cron parado pode esconder produtos novos?

Sim. Se os indexadores estiverem no modo de atualização por agendamento, um cron parado impede que alterações do catálogo sejam processadas normalmente. É necessário corrigir o agendador, e não apenas executá-lo manualmente uma vez.