Magento MySQL 8 fim do suporte tornou-se um ponto importante no planejamento de infraestrutura de lojas que ainda operam com Adobe Commerce 2.4.7, 2.4.6, 2.4.5 ou 2.4.4. O banco não deve ser atualizado isoladamente: versão da aplicação, edição, patch, extensões, integrações e método de migração precisam ser avaliados em conjunto.
O MySQL 8.0 chegou ao fim do suporte em 30 de abril de 2026. A Adobe também informa que as linhas 2.4.7, 2.4.6, 2.4.5 e 2.4.4 não terão compatibilidade ou suporte para versões principais do MySQL posteriores à 8.0, conforme a matriz oficial de requisitos do Adobe Commerce. Portanto, simplesmente instalar uma versão principal mais nova do MySQL pode criar uma combinação não validada para a loja.
Quais lojas são afetadas pelo fim do suporte do MySQL 8?
O primeiro grupo que precisa revisar a arquitetura é formado por operações on-premises nas linhas citadas que usam MySQL 8.0. Também merecem atenção ambientes hospedados por terceiros nos quais a equipe não sabe exatamente qual mecanismo ou versão está por trás do serviço gerenciado.
A Adobe recomenda que clientes on-premises dessas linhas migrem seus servidores de banco para uma versão compatível do MariaDB, em vez de avançar para uma versão principal posterior do MySQL sem validação oficial. A orientação e as combinações aceitas devem ser verificadas na documentação de requisitos do sistema em português.
Isso não significa que toda loja deva trocar o banco imediatamente ou escolher a versão mais nova do MariaDB. Antes de decidir, confirme:
- a edição instalada: Adobe Commerce ou Magento Open Source;
- a versão completa da aplicação, incluindo o patch;
- o mecanismo e a versão exata do banco em produção;
- as versões usadas em homologação, desenvolvimento e recuperação de desastre;
- as limitações da hospedagem ou do serviço gerenciado;
- o suporte declarado por extensões e integrações críticas.
Como descobrir se o Magento usa MySQL 8.0
Não presuma a versão a partir do painel da hospedagem. Consulte a aplicação e o próprio servidor de banco. No diretório do Magento, a versão da plataforma pode ser conferida com:
php bin/magento --versionTambém é possível identificar o metapacote instalado sem atualizar dependências:
composer show magento/product-enterprise-edition
composer show magento/product-community-editionExecute apenas o comando correspondente à edição ou use composer show | grep magento/product para localizar o pacote. Para descobrir o banco, abra uma conexão autorizada com o cliente SQL e consulte:
SELECT VERSION();
SELECT @@version_comment;O primeiro resultado apresenta a versão. O segundo ajuda a distinguir MySQL, MariaDB ou uma distribuição fornecida pelo provedor. Evite colocar senhas diretamente na linha de comando, pois elas podem ficar registradas no histórico ou visíveis para outros processos.
Se os resultados divergirem do inventário interno, documente a descoberta antes de mudar qualquer componente. Em ambientes com réplicas, confirme também se todos os nós executam versões coerentes.
Como escolher uma versão compatível do MariaDB
A escolha deve começar na matriz da versão exata do Commerce, e não na página de download do banco. Compatibilidade anunciada para uma linha nova não se transfere automaticamente para versões antigas.
O Adobe Commerce 2.4.9 adiciona suporte ao MariaDB 11.8 e 12.x, mas essa informação não deve ser usada para concluir que as mesmas versões funcionam em 2.4.7, 2.4.6, 2.4.5 ou 2.4.4. A compatibilidade precisa ser conferida para a linha instalada, como deixam claro as notas oficiais do Adobe Commerce 2.4.9.
Há duas decisões diferentes: atualizar primeiro o Commerce ou manter temporariamente a aplicação e migrar somente o banco para uma versão MariaDB admitida por sua matriz. A resposta depende da vida útil da versão instalada, do código personalizado e da capacidade de homologação. Se o projeto também considera uma atualização ampla de plataforma, vale revisar o checklist de compatibilidade entre Magento 2.4.9, PHP e módulos.
Checklist para migrar do MySQL 8.0 para MariaDB
1. Faça um inventário técnico
Registre versão do Commerce, PHP, driver de banco, tamanho das bases, tabelas maiores, extensões, integrações, rotinas de importação e recursos do provedor. Procure SQL personalizado em módulos próprios, relatórios e conectores de ERP, antifraude, emissão fiscal e marketplaces.
2. Crie uma homologação representativa
A homologação deve usar uma cópia sanitizada dos dados e arquitetura próxima à produção. O objetivo não é apenas abrir a página inicial, mas reproduzir volume, consultas, indexação, cron e integrações relevantes. Dados pessoais e credenciais precisam ser removidos ou protegidos.
3. Defina o método e a janela de migração
Escolha entre exportação e restauração lógica, recursos oferecidos pelo provedor ou outra estratégia administrada pela equipe de banco. Calcule o tempo de cópia, validação e reversão com testes reais. Não considere MySQL e MariaDB intercambiáveis sem validar tipos, collations, modos SQL, funções e consultas personalizadas.
4. Prepare backup e rollback verificáveis
Um arquivo de backup existente não basta. Teste a restauração, registre duração e confirme se usuários, permissões, eventos e configurações necessárias foram recuperados. O rollback deve indicar quem decide, quais serviços são interrompidos e como evitar que pedidos sejam gravados nos dois ambientes.
5. Compare estrutura e dados
Depois da restauração, compare quantidade de tabelas, integridade, contagens relevantes e registros recentes. Não edite tabelas do Magento manualmente para corrigir diferenças. Investigue primeiro se a causa está no processo de exportação, charset, permissões ou configuração do banco.
O que testar depois da migração
A validação deve cobrir fluxos comerciais e rotinas de retaguarda:
- login de cliente, criação de conta e recuperação de senha;
- produto simples, configurável e demais tipos usados pela loja;
- busca, categorias, preços, regras promocionais e cupons;
- carrinho, cálculo de frete, checkout de convidado e cliente autenticado;
- PIX, cartão, boleto, callbacks e atualização de status;
- criação de pedido, fatura, envio, cancelamento e reembolso;
- reserva, baixa e atualização de estoque;
- Admin, relatórios, importação, exportação, API e ERP;
- cron, filas, indexadores e envio de e-mails.
Meça também latência, consultas lentas, consumo de CPU, bloqueios e tempo de indexação. Uma migração pode funcionar do ponto de vista funcional e ainda introduzir degradação. Se isso ocorrer, use uma abordagem por camadas semelhante ao diagnóstico de gargalos de PHP, banco, cache e frontend.
Erros que aumentam o risco da mudança
- atualizar para uma versão principal posterior do MySQL sem suporte declarado;
- usar a matriz do Commerce 2.4.9 para justificar o banco de uma linha antiga;
- migrar diretamente em produção sem restauração ensaiada;
- validar apenas a home e o painel administrativo;
- ignorar SQL personalizado de módulos e integrações;
- não prever indisponibilidade, congelamento de gravações e rollback;
- aproveitar a janela para alterar PHP, banco, sistema operacional e módulos simultaneamente sem isolar os riscos.
Perguntas frequentes
Como descobrir se o Magento está usando MySQL 8.0?
Consulte SELECT VERSION(); e SELECT @@version_comment; em uma conexão autorizada. Depois, compare o resultado com a versão completa do Magento ou Adobe Commerce e sua matriz oficial.
Qual banco é compatível com Adobe Commerce 2.4.6?
A resposta depende da versão de patch instalada. Consulte a linha correspondente na matriz oficial de requisitos e não extrapole a compatibilidade anunciada para o Commerce 2.4.9.
Posso trocar MySQL por MariaDB sem reinstalar o Magento?
A migração de dados pode ser feita sem reinstalar a aplicação, mas não deve ser tratada como uma simples troca de endereço. É necessário validar compatibilidade, restaurar uma cópia em homologação, testar o código e preparar rollback.
Quais testes devem ser feitos depois da migração?
Teste checkout, pagamentos, pedidos, estoque, catálogo, busca, Admin, APIs, ERP, cron, filas, indexadores e e-mails. Compare também desempenho, erros de aplicação, consultas lentas e integridade dos dados.
Planeje antes que o banco vire uma dependência sem saída
O cenário de Magento MySQL 8 fim do suporte não deve ser resolvido com uma atualização automática do servidor. Identifique a pilha instalada, consulte a matriz correta, escolha uma versão compatível do MariaDB e valide a operação completa em homologação.
Se sua equipe precisa mapear dependências, preparar a migração ou investigar incompatibilidades, o suporte especializado em Magento pode ajudar a estruturar o diagnóstico e o plano de mudança com menor risco operacional.
Fontes consultadas
As informações atuais mencionadas neste artigo foram verificadas nas fontes abaixo.
