Atualização do Shopware 6 sem perder vendas: checklist de antes e depois
19 de nov. de 2026 · 7 min de leitura
Uma atualização do Shopware 6 raramente falha por causa do núcleo, e sim por plugins, tema, meios de pagamento e rastreamento. Este checklist mostra o que preparar, como executar e o que conferir depois.
Por que uma atualização do Shopware pode custar vendas
Para a maioria das lojas, atualizar o Shopware 6 é rotina. Quando algo dá errado, raramente a culpa é do núcleo da plataforma. O problema costuma estar em tudo o que está ligado a ele: plugins, um tema personalizado, integrações de pagamento, scripts de rastreamento e processos em segundo plano. Se um desses itens quebra, nem sempre você percebe na hora. A página inicial abre, as páginas de produto parecem normais, mas o Pix não aparece no checkout ou o e-mail de confirmação do pedido deixa de ser enviado.
Consequências típicas de uma atualização sem preparo:
- Um plugin não é compatível com a nova versão e é desativado ou passa a gerar erros.
- Personalizações de template no tema deixam de combinar com os templates alterados da vitrine.
- Um meio de pagamento some ou falha na última etapa.
- O evento de compra para de chegar ao analytics, e as campanhas passam a ser otimizadas com dados errados.
- Processos em segundo plano continuam rodando código antigo porque ninguém reiniciou os workers.
Os princípios deste guia valem também para outras plataformas. A boa notícia: com uma sequência fixa de passos, dá para evitar a maior parte desses problemas antes da atualização ou identificá-los logo depois.
Antes da atualização: ambiente de homologação e backups
Teste toda atualização primeiro em um ambiente de homologação (staging), ou seja, uma cópia da loja em produção em outro servidor ou subdomínio. Ela deve ser o mais parecida possível com a loja real: mesma versão de PHP, mesmos plugins nas mesmas versões, banco de dados recente e o mesmo tema.
O que importa na homologação:
- Segurar os e-mails. Caso contrário, clientes reais recebem mensagens de teste. Uma ferramenta de captura de e-mails ou o envio desativado resolve isso.
- Pagamentos em modo de teste. A maioria dos intermediadores e gateways oferece ambiente sandbox para cartão, Pix e boleto. Credenciais de produção não devem ficar na homologação, inclusive porque algumas integrações registram webhooks para o domínio atual ao salvar as configurações.
- Proteger o acesso. Uma senha impede que buscadores e clientes encontrem a cópia.
Antes da atualização em produção, você precisa de um backup completo que realmente possa ser restaurado: dump do banco de dados, mídias e arquivos (por exemplo public/media e files), configuração (.env, chaves JWT) e o código, incluindo custom/plugins. Backup que nunca foi restaurado é esperança, não plano. Restaure-o ao menos uma vez na homologação para saber quanto tempo leva.
Verifique a compatibilidade dos plugins e do tema
Plugins são a causa mais comum de problemas depois de uma atualização. Antes de começar, revise a lista de plugins instalados:
- Existe, para cada plugin, uma versão que o fornecedor declara compatível com a versão de destino do Shopware?
- Quais plugins estão instalados mas não são mais usados? Remova-os de forma limpa antes da atualização, em vez de carregá-los adiante.
- Quais plugins mexem no checkout, no carrinho ou no pagamento? Eles merecem atenção redobrada nos testes.
Versões menores e de correção normalmente mantêm as interfaces para extensões estáveis. Já uma versão major, ou seja, um salto no segundo número da versão como de 6.5 para 6.6, altera interfaces de propósito e remove funções obsoletas. Leia as notas de upgrade do Shopware e confira se os requisitos de PHP ou de banco de dados mudam.
Revise código próprio e personalizações do tema junto com a sua agência ou desenvolvedor. Templates Twig sobrescritos e plugins JavaScript próprios da vitrine são frágeis quando os templates originais mudam. Na homologação isso costuma aparecer rápido: elementos faltando, layout quebrado ou erros no console do navegador.
Escolha o horário certo e siga uma rotina no dia
Escolha um horário com poucos pedidos. Quem diz quais são essas horas são os dados de pedidos da sua loja, não recomendações genéricas. Evite dias de promoção, disparo de newsletter ou campanhas grandes, como datas próximas à Black Friday, e garanta que alguém tenha tempo para conferir tudo depois. Atualizar na sexta à noite sem ninguém disponível no dia seguinte é arriscado.
Uma rotina que funciona:
- Faça um backup novo imediatamente antes da atualização.
- Ative o modo de manutenção nos canais de venda e libere o seu próprio IP para continuar testando.
- Execute a atualização, pela Administração ou via Composer seguido de
bin/console system:update:finish, conforme o tipo de instalação. - Atualize os plugins, recompile o tema e limpe o cache.
- Reinicie os workers da fila de mensagens e as tarefas agendadas para que usem o código novo.
- Faça um teste rápido a partir do IP liberado e só então desative o modo de manutenção.
Defina antes em que situação você vai abortar e restaurar o backup. Essa decisão é difícil de tomar sob pressão se não estiver preparada.
Depois da atualização: compra de teste com cada meio de pagamento e tracking
O teste mais importante depois da atualização é uma compra real com cada meio de pagamento ativo. Um pedido de teste via boleto não diz nada sobre Pix ou cartão, porque cada meio tem a sua integração, com scripts, redirecionamentos e notificações próprios.
Para cada meio de pagamento, confira:
- Ele aparece no checkout, inclusive para visitantes sem cadastro e no celular?
- O QR code do Pix é gerado, o boleto é emitido, o cartão é aprovado no fluxo normal, incluindo parcelamento se você oferece?
- O pedido recebe o status de pagamento correto na Administração depois da confirmação?
- O e-mail de confirmação do pedido chega?
Depois, cancele e estorne os pedidos de teste para não distorcer estoque e relatórios.
Em seguida, verifique o rastreamento. Abra a loja no modo de visualização do Google Tag Manager ou com as ferramentas de desenvolvedor do navegador e confirme se o banner de cookies aparece, se as tags só disparam depois do consentimento e se a página de agradecimento envia o evento purchase com transaction_id e valor. Templates personalizados são uma causa frequente de eventos ausentes, porque o código de rastreamento costuma estar justamente neles.
Monitore a loja nos dias seguintes à atualização
Alguns problemas não aparecem na compra de teste, só com tráfego real: um erro que afeta apenas certas regiões de entrega, um plugin que falha com carrinhos grandes, um meio de pagamento que trava em um navegador específico. Por isso, nos primeiros dias, acompanhe de perto:
- Pedidos por hora e por dia, comparando com o mesmo dia da semana nas semanas anteriores.
- Participação de cada meio de pagamento. Se o Pix cai a zero enquanto o total de pedidos parece normal, o sinal é claro.
- Logs de erro em
var/loge os logs do servidor web e do PHP. Erros novos que começam no horário da atualização merecem atenção. - Tempos de carregamento dos principais tipos de página, já que um cache desativado ou um plugin com defeito pode deixar a loja visivelmente mais lenta.
- Diferença entre loja e analytics. Se os pedidos no Shopware estão estáveis mas as compras no GA4 caem, o problema é de rastreamento, não de faturamento.
Anote data e hora da atualização. Quem investigar uma queda depois economiza muito tempo sabendo o que mudou e quando.
Checklist da atualização do Shopware 6
Antes da atualização:
- Homologação atualizada, e-mails retidos, pagamentos em sandbox
- Versões compatíveis confirmadas para todos os plugins, plugins sem uso removidos
- Notas de upgrade e requisitos de sistema lidos, principalmente em versões major
- Atualização totalmente testada na homologação, incluindo o checkout
- Backup de banco, arquivos e configuração feito e restauração testada
- Horário de pouco movimento escolhido, sem promoções em andamento
- Critério de rollback e responsáveis definidos
Depois da atualização:
- Workers e tarefas agendadas reiniciados, cache limpo, tema compilado
- Compra de teste com Pix, boleto, cartão e demais meios ativos, como visitante e com conta, no desktop e no celular
- E-mail de confirmação e status de pagamento conferidos
- Banner de consentimento, tags e evento de compra conferidos
- Pedidos, participação dos meios de pagamento, logs e tempos de carregamento acompanhados por alguns dias
Como acompanhar a loja depois da atualização
Se você prefere não comparar pedidos e logs manualmente todos os dias depois de uma atualização, o Profit Guard pode assumir esse acompanhamento: o plugin para Shopware 6 aprende os padrões habituais da sua loja e avisa sobre desvios no checkout, nos meios de pagamento, no funil e em erros de front-end, sempre com a causa provável e uma recomendação.
Perceba problemas antes que custem vendas
O Profit Guard roda como plugin na sua loja Shopware e avisa sobre falhas no checkout, problemas de pagamento e quedas na jornada de compra.
Conhecer o Profit Guard