Quando o Live Search 4.7.3 no Magento e o Adicionar ao carrinho não funciona, a falha pode interromper a compra diretamente na página de categoria ou nos resultados de busca. Antes de modificar o tema, desativar módulos ou culpar o checkout, é importante confirmar se a listagem utiliza o PLP Widget, descobrir a versão instalada e reproduzir o problema de maneira controlada.
A versão 4.7.3 do Live Search foi publicada em 28 de agosto de 2026, é compatível com Adobe Commerce 2.4.5 ou superior e corrige um problema no qual a função Adicionar ao carrinho da página de listagem de produtos não operava com o PLP Widget em determinados casos isolados, conforme as notas oficiais de versão do Live Search.
Qual é o impacto da falha corrigida no Live Search 4.7.3?
O botão de compra presente na listagem reduz o número de etapas entre a descoberta do produto e a entrada no carrinho. Quando ele não responde, o cliente pode interpretar que o item está indisponível, abandonar a navegação ou precisar abrir a página do produto para continuar.
Isso não significa que toda falha de Adicionar ao carrinho em uma categoria seja causada pelo Live Search. O mesmo sintoma pode resultar de erro JavaScript no tema, configuração obrigatória não selecionada, formulário inválido, token de segurança, sessão, estoque, extensão de terceiros ou personalização do próprio botão. A atualização deve fazer parte do diagnóstico, e não substituir a investigação.
Live Search 4.7.3 Magento: Adicionar ao carrinho não funciona em qual cenário?
Comece verificando onde a falha aparece. Registre a URL, store view, grupo de cliente, SKU, tipo de produto, navegador, dispositivo e horário do teste. Depois, compare estes caminhos:
- resultado apresentado na busca com Live Search;
- página de categoria que utiliza o PLP Widget;
- página tradicional de listagem, caso exista no projeto;
- página individual do mesmo produto;
- desktop e dispositivo móvel;
- sessão anônima e cliente autenticado.
Se o produto entra no carrinho pela página individual, mas o botão falha somente na listagem controlada pelo widget, há um indício relevante de problema nessa camada. Se a falha ocorre em todos os caminhos, investigue também sessão, estoque, formulário e processamento do carrinho. Em casos nos quais o item entra e depois desaparece, siga o diagnóstico específico para quando o carrinho Magento 2 esvazia sozinho.
1. Confirme se a loja realmente utiliza o PLP Widget
Não basta ter o Live Search instalado. A vitrine pode usar uma implementação própria, um tema headless ou a listagem tradicional do Commerce. Inspecione a página, a configuração da extensão e a documentação técnica do projeto para identificar quem renderiza os cards e controla o clique de compra.
Abra também as ferramentas de desenvolvimento do navegador. Na aba Console, procure erros disparados ao carregar a listagem ou clicar no botão. Na aba Rede, confirme se existe uma requisição de inclusão no carrinho, qual código HTTP foi retornado e se a resposta contém uma mensagem de validação.
2. Descubra a versão instalada do Live Search
Execute a consulta no diretório raiz da aplicação, preferencialmente com o mesmo usuário empregado no deploy:
composer show magento/live-searchConfira o campo de versão e não dependa apenas do painel administrativo ou do arquivo composer.json. O composer.lock representa a versão resolvida pelo Composer, enquanto o conteúdo implantado no servidor precisa corresponder ao artefato aprovado.
Registre ainda a versão do Adobe Commerce, o commit do projeto e a data do último deploy. A compatibilidade declarada para o Live Search 4.7.3 começa no Adobe Commerce 2.4.5, de acordo com as notas de versão da Adobe. Isso não elimina a necessidade de validar tema, módulos e infraestrutura da loja.
3. Reproduza a falha antes de atualizar
Um teste reproduzível permite saber se a atualização realmente corrigiu o comportamento. Monte uma pequena matriz com produtos simples, configuráveis e itens com opções obrigatórias. Teste também produtos com preço promocional, diferentes condições de estoque e restrições por grupo de cliente, quando aplicável.
Ao clicar em Adicionar ao carrinho, observe se há mudança visual, mensagem de sucesso, atualização do minicarrinho e criação da requisição. Confirme no backend se a quote recebeu o item. Assim, você separa uma falha visual de uma inclusão que ocorreu no servidor, mas não foi refletida no frontend.
4. Prepare a atualização fora da produção
Faça a mudança em ambiente de desenvolvimento ou homologação criado a partir de uma versão representativa do projeto. Preserve composer.json, composer.lock, configurações, banco de dados e mídia conforme a política de backup da operação.
Antes de alterar dependências, consulte as restrições atuais:
composer show magento/live-search
composer why magento/live-search
composer outdated magento/live-searchAtualize o pacote dentro da estratégia de dependências adotada pela equipe. Quando a restrição existente permitir a versão pretendida, uma abordagem possível em homologação é:
composer update magento/live-search --with-dependenciesSe o Composer bloquear a operação, não apague o composer.lock nem execute uma atualização global por impulso. Identifique o pacote e a restrição responsáveis. O processo é semelhante ao diagnóstico de um conflito no Composer do Magento 2.
Revise o diff dos arquivos do Composer, confirme a versão resolvida e execute o procedimento de build e deploy usado pelo projeto. Não transforme o primeiro teste em uma alteração direta na loja ativa.
5. Teste o botão e os efeitos da compra
Depois da atualização, repita exatamente os cenários registrados antes da mudança. A validação não deve terminar quando aparece uma mensagem verde. Confira:
- inclusão de uma única unidade e de várias unidades;
- produtos simples, configuráveis e com opções obrigatórias;
- preço regular, preço promocional e preço por grupo;
- quantidade vendável e mensagem de indisponibilidade;
- atualização do minicarrinho e persistência após recarregar a página;
- remoção e alteração de quantidade no carrinho;
- funcionamento em desktop e mobile;
- busca, filtros, ordenação e paginação antes da compra;
- fluxo completo até frete, pagamento e criação do pedido.
Como o problema ocorre próximo da conversão, valide pelo menos um pedido de teste com cada combinação comercial crítica da loja. Se as opções de entrega desaparecerem depois da inclusão, utilize também as verificações para quando o frete não aparece no checkout Magento 2.
6. Diferencie correção do Live Search de erro no tema
Se a versão 4.7.3 estiver instalada e a falha continuar, verifique o Console do navegador novamente. Um tema pode substituir templates, interceptar eventos ou modificar o formulário usado pelo card. Extensões de analytics, personalização, consentimento, parcelamento e quick view também podem interferir no clique.
Compare temporariamente o comportamento em uma implementação limpa de homologação, sem remover módulos da produção. Analise ainda se o botão está dentro de um formulário válido, se o identificador do produto corresponde ao item exibido e se não há elementos sobrepostos capturando o toque no mobile.
Uma requisição enviada e rejeitada pelo servidor pede análise dos logs e da resposta HTTP. Já a ausência completa de requisição normalmente direciona a investigação para JavaScript, evento, marcação ou bloqueio no navegador.
7. Planeje deploy, monitoramento e reversão
O deploy deve ter janela definida, responsável técnico, evidência dos testes e plano de reversão do código. Evite reverter somente parte das dependências: aplicação, arquivos do Composer e artefatos gerados precisam permanecer consistentes.
Após publicar, acompanhe erros de frontend e backend, respostas das requisições de carrinho e comportamento dos pedidos. Compare os cenários testados, sem concluir que uma oscilação comercial isolada comprova falha ou sucesso técnico. Caso seja necessário limpar caches, faça isso de maneira controlada e de acordo com a arquitetura da loja.
Conclusão
A correção do Live Search 4.7.3 Magento Adicionar ao carrinho não funciona é relevante para lojas que utilizam o PLP Widget, mas a versão deve ser confirmada e o defeito precisa ser reproduzido antes da atualização. O caminho seguro é identificar a camada responsável, atualizar em homologação, testar produtos e dispositivos diferentes e validar o pedido completo.
Se sua equipe não consegue determinar se o problema está no Live Search, no tema ou no carrinho, um diagnóstico técnico pode reduzir tentativas arriscadas. A equipe do SuporteMagento.com.br pode ajudar a revisar o ambiente, planejar a atualização e validar o fluxo de compra.
Perguntas frequentes sobre o Live Search 4.7.3
Como descobrir a versão do Live Search instalada no Magento?
No diretório raiz do projeto, execute composer show magento/live-search. Confira a versão exibida e confirme se o código implantado corresponde ao composer.lock aprovado no último deploy.
É possível atualizar o Live Search sem atualizar todo o Adobe Commerce?
O Live Search é distribuído como uma dependência do projeto e pode ser atualizado separadamente quando as restrições e a compatibilidade permitirem. A alteração deve ser resolvida pelo Composer e testada em homologação antes do deploy.
O que testar depois de instalar o Live Search 4.7.3?
Teste o botão em busca e categorias, produtos de tipos diferentes, preços, estoque, minicarrinho, clientes autenticados e anônimos, desktop e mobile. Finalize ao menos um pedido de teste para validar o fluxo completo.
Como saber se a falha está no Live Search ou no tema Magento?
Compare a listagem do widget com a página individual do produto, examine Console e Rede no navegador e verifique se uma requisição é enviada. Ausência de requisição costuma indicar interferência no frontend; rejeição do servidor exige analisar resposta e logs.
Fontes consultadas
As informações atuais mencionadas neste artigo foram verificadas nas fontes abaixo.
