Checkout Magento 2 fica carregando, não mostra os métodos de entrega, bloqueia o pagamento ou mantém o botão de compra desabilitado? Embora o problema apareça em uma única tela, sua origem pode estar no JavaScript, em uma requisição de API, na sessão, no cálculo de frete, no gateway ou em alguma personalização.
Antes de limpar todos os caches, reiniciar serviços ou desativar módulos em produção, escolha um carrinho controlado e registre exatamente onde o carregamento parou. Os nove testes a seguir ajudam a separar uma falha visual de um bloqueio real no processamento da compra.
Checkout Magento 2 fica carregando: delimite o sintoma
Comece identificando qual componente não termina de carregar. A página pode abrir normalmente, mas falhar ao buscar endereços, calcular o frete, listar pagamentos ou enviar o pedido. Esses cenários percorrem rotas e integrações diferentes.
Registre horário, navegador, dispositivo, visão de loja, itens do carrinho, CEP, método de entrega e condição do cliente. Teste visitantes e usuários autenticados, sem reutilizar o mesmo carrinho indefinidamente. Caso o item nem chegue a essa etapa, consulte também o diagnóstico para quando o produto não adiciona ao carrinho no Magento 2.
1. Descubra se o erro ocorre antes ou depois do checkout
Abra uma janela anônima, crie um carrinho novo e use um produto simples disponível. Verifique se o problema acontece ao acessar a rota de checkout ou somente depois de informar endereço, CEP ou forma de pagamento.
- Se a página não monta, investigue JavaScript, layout, sessão e conteúdo estático.
- Se o frete não aparece, concentre-se na cotação, no endereço e na transportadora.
- Se apenas o pagamento fica carregando, verifique o módulo, os tokens e as chamadas ao provedor.
- Se o clique final não responde, acompanhe a requisição de criação do pedido.
Repita o teste com poucos itens. Carrinhos antigos, produtos desativados, opções alteradas ou regras comerciais específicas podem produzir um resultado diferente de uma compra recém-iniciada.
2. Examine o Console e a aba Network do navegador
Abra as ferramentas de desenvolvimento antes de recarregar a página. No Console, procure erros JavaScript, módulos que não foram carregados e bloqueios de conteúdo. Na aba Network, filtre por requisições XHR ou Fetch e observe chamadas pendentes ou respostas com códigos 400, 401, 403, 404, 500 e 503.
Abra a resposta da primeira requisição que falhou. Uma mensagem genérica exibida no checkout pode esconder uma exceção mais útil retornada pela API. Preserve URL, método, status, tempo de resposta e identificadores de rastreamento, mas não compartilhe cookies, tokens, dados pessoais ou informações de cartão.
3. Verifique logs sem apagar as evidências
Relacione o horário registrado no navegador com os arquivos em var/log, os relatórios em var/report e os logs do servidor web, PHP e serviços externos. Em uma instalação padrão, uma consulta inicial pode ser feita com:
tail -n 200 var/log/system.log
tail -n 200 var/log/exception.logTambém pesquise pelo horário, rota, carrinho ou mensagem observada na resposta. Evite esvaziar arquivos antes da análise: a sequência anterior ao erro pode revelar falhas de dependência, timeout, exceção de módulo ou indisponibilidade de serviço.
4. Diferencie código estático, cache e deploy incompleto
Se o problema surgiu após deploy, atualização de tema ou instalação de extensão, confirme se o código publicado corresponde ao pacote homologado. Arquivos JavaScript antigos no navegador, CDN ou proxy podem ser combinados com uma versão nova do backend.
Consulte o estado dos caches com um usuário adequado à aplicação:
bin/magento cache:status
bin/magento deploy:mode:showNão execute uma limpeza ampla apenas para testar uma hipótese. Compare primeiro o comportamento em uma URL sem cache, revise o versionamento dos arquivos estáticos e confirme se a publicação terminou sem erro. Caso o deploy tenha parado durante a resolução de pacotes, use o roteiro para diagnosticar erro do Composer no Magento 2 antes de modificar o arquivo de dependências.
5. Teste sessão, cookies e armazenamento local
O checkout depende da continuidade entre carrinho, sessão e navegador. Cookies incompatíveis com domínio, HTTPS ou subdomínio podem fazer a loja perder o contexto durante a compra. Compare a configuração usada no frontend com o domínio efetivamente acessado e verifique se redirecionamentos alternam entre endereços diferentes.
No navegador, observe se o cookie de sessão é preservado entre as requisições. Teste também uma janela anônima e outro navegador. Se o problema ocorrer somente em sessões antigas, investigue dados persistidos no armazenamento local e no carrinho, em vez de concluir que toda a loja está indisponível.
6. Isole o cálculo de frete e o endereço
Quando o carregamento começa após informar o CEP, teste um endereço válido e conhecido pela operação. Compare regiões atendidas e não atendidas, produtos com pesos diferentes e métodos offline, quando já estiverem configurados para homologação.
Uma integração de frete pode responder lentamente, rejeitar dimensões ou devolver um formato inesperado. Confira o tempo da requisição e os registros do conector. Não exponha credenciais nem force uma cotação diretamente contra um serviço de terceiros sem autorização. Se apenas uma transportadora falhar, mantenha o diagnóstico restrito ao módulo e às regras associadas a ela.
7. Desative conflitos somente em ambiente controlado
Temas e extensões podem sobrescrever componentes do checkout. Entretanto, desligar módulos diretamente em produção pode quebrar injeção de dependências, configurações ou dados necessários à compra.
Reproduza o cenário em homologação com uma cópia sanitizada das configurações relevantes. Compare o tema personalizado com o tema de referência e revise alterações em componentes JavaScript, layouts, plugins e mixins. Faça uma mudança por vez e registre o resultado; caso contrário, o checkout pode voltar a funcionar sem que a causa seja identificada.
8. Valide o método de pagamento sem criar cobranças repetidas
Se o checkout trava ao selecionar ou enviar o pagamento, consulte o Console, a aba Network e os logs do módulo. Confirme se campos obrigatórios foram renderizados, se a tokenização terminou e se o backend recebeu a solicitação.
Não clique repetidamente no botão final. Antes de tentar de novo, verifique no Magento e no painel autorizado do provedor se houve transação, autorização ou pedido. Repetições sem essa conferência podem contribuir para pedidos ou cobranças duplicadas. Se já houver duas vendas semelhantes, siga o procedimento para investigar pedidos duplicados no Magento 2.
9. Acompanhe a criação do pedido até a resposta final
Quando todos os campos aparecem, mas a finalização permanece carregando, acompanhe a requisição iniciada pelo botão de compra. Descubra se ela chegou ao servidor, quanto tempo levou e qual resposta retornou.
Verifique se o pedido foi gravado mesmo sem a confirmação visual. Depois, acompanhe pagamento, estoque, e-mail e integração com ERP separadamente. Uma página de sucesso ausente não prova que a venda falhou, assim como uma animação interminável não confirma que nenhum processamento ocorreu.
O que evitar durante o diagnóstico
- apagar carrinhos, logs ou relatórios antes de preservar evidências;
- editar diretamente tabelas de quote, pedido ou pagamento;
- repetir compras reais para descobrir se a primeira tentativa funcionou;
- desativar extensões essenciais diretamente na loja em produção;
- limpar todos os caches e reiniciar serviços sem registrar o estado anterior;
- compartilhar tokens, cookies, credenciais ou dados pessoais em chamados.
Conclusão
Quando o checkout Magento 2 fica carregando, a investigação deve seguir a compra do navegador até o servidor, sem misturar erros de interface, frete, sessão e pagamento. Um teste controlado, acompanhado pela aba Network e pelos logs, costuma indicar exatamente em qual etapa o fluxo foi interrompido.
Se a falha não puder ser reproduzida com segurança ou envolver integrações críticas, uma análise técnica especializada pode reduzir tentativas em produção e preservar as evidências. A equipe do Suporte Magento pode apoiar o diagnóstico do checkout, das personalizações e dos serviços conectados à loja.
Perguntas frequentes
Por que o checkout Magento 2 fica carregando sem parar?
As causas possíveis incluem erro JavaScript, requisição de API pendente, sessão perdida, falha no cálculo de frete, módulo de pagamento ou incompatibilidade de uma personalização. O primeiro passo é identificar qual chamada ficou pendente na aba Network.
Posso limpar o cache para corrigir o checkout?
A limpeza pode remover conteúdo desatualizado, mas não corrige necessariamente a causa. Consulte o estado dos caches, preserve logs e confirme se existe divergência entre frontend e backend antes de fazer uma limpeza ampla.
Como saber se o pedido foi criado mesmo com a tela travada?
Consulte os pedidos no Admin, os registros da aplicação e o painel autorizado do pagamento antes de repetir a compra. Uma falha na confirmação visual pode ocorrer depois da gravação do pedido.
É seguro desativar módulos para testar?
O teste deve ser feito preferencialmente em homologação, com uma alteração por vez. Desativar módulos no ambiente de produção pode causar novas falhas e dificultar a identificação da origem.
