Migração & Legado

Data Migration Tool não tem versão 2.4.9: migre no 2.4.8 antes

A regra da Adobe é que a versão do tool tem que ser a mesma do Magento. Só que a última release do tool é de junho de 2025 e o 2.4.9 saiu quase um ano depois.

Por Roger Takemiya · Publicado em · 4 min de leitura

Você monta o Magento novo já na última versão, 2.4.9, roda o composer require magento/data-migration-tool:2.4.9 e o composer responde que o pacote não existe nessa versão. Não é problema das suas chaves de acesso nem do repo.magento.com.

A release mais nova do tool é a 2.4.8.1, publicada em 03/06/2025. O Magento 2.4.9 saiu em 12/05/2026. O tool simplesmente não acompanhou.

A versão do tool precisa bater com a do Magento

A documentação de instalação da Adobe é direta: as versões do Magento e do Data Migration Tool têm que ser iguais. Não é recomendação de estilo — o tool lê o schema do destino pra montar os mapeamentos, e um schema de outra versão quebra a migração no meio.

Olhando as tags publicadas no repositório, a lista termina assim:

Release do toolPublicada em
2.4.8.103/06/2025
2.4.709/04/2024
2.4.6.129/08/2023
2.4.614/03/2023

Repare que nem existe uma 2.4.8 sem sufixo. A 2.4.8.1 é a própria correção da linha 2.4.8, e é ela que você instala.

E o composer nem deixa você forçar

A tentação é tentar a 2.4.8.1 mesmo dentro de um 2.4.9. Não passa, e o motivo está no composer.json dos dois:

Pacotesymfony/consolePHP
Magento 2.4.8^6.48.2, 8.3, 8.4
Magento 2.4.9^7.48.3, 8.4, 8.5
data-migration-tool 2.4.8.1^6.4—

O tool pede Symfony Console 6, o 2.4.9 já subiu pra 7. Um exclui o outro e o resolver do composer para na hora, com aquela parede de "Your requirements could not be resolved". Não adianta --ignore-platform-reqs: o conflito é entre pacotes, não com a sua máquina.

A mensagem que aparece cita o magento/data-migration-tool 2.4.8.1 pedindo symfony/console ^6.4 e o magento/product-community-edition 2.4.9 travando o Symfony em 7. Quando bater essa parede, confira em que versão você está antes de sair tentando coisa:

php bin/magento --version
composer show magento/product-community-edition | head -3

E se o destino já está no 2.4.9?

Acontece bastante: o servidor novo foi montado com a última versão porque parecia o certo a fazer, e a migração só entrou na conversa depois. Dá pra descer de 2.4.9 para 2.4.8, mas não vale a pena se ainda não tem nada dentro.

Se a loja está vazia, apague e instale de novo fixando a versão:

composer create-project --repository-url=https://repo.magento.com/ \
  magento/project-community-edition=2.4.8 loja

Se já tem trabalho feito ali — tema, módulos, configuração —, dá pra baixar o metapackage no lugar sem perder nada, desde que o banco ainda não tenha dado de produção:

composer require magento/product-community-edition=2.4.8 --no-update
composer update --no-dev
php bin/magento setup:upgrade

Descer versão do Magento com pedido, cliente e estoque dentro é outra história e não é isso que estou recomendando. Aqui a loja de destino está vazia por definição: o conteúdo dela vai vir do Magento 1.

A ordem que funciona

Suba o destino em 2.4.8, migre, depois atualize. Instalação do tool:

composer config repositories.magento composer https://repo.magento.com
composer require magento/data-migration-tool:2.4.8.1
php bin/magento setup:upgrade

Confirme o que entrou antes de continuar:

composer show magento/data-migration-tool | head -3
php bin/magento list | grep migrate

Você precisa ver os três comandos: migrate:settings, migrate:data e migrate:delta. O arquivo de configuração de cada um sai do config.xml.dist da pasta da sua versão de origem, dentro de vendor/magento/data-migration-tool/etc/opensource-to-opensource/. As pastas vão até 1.9.4.5, que é a última do Magento 1 Open Source.

Com a migração fechada e a loja conferida, aí sim o upgrade:

composer require magento/product-community-edition=2.4.9 --no-update
composer update --no-dev
php bin/magento setup:upgrade
php bin/magento setup:di:compile

Um detalhe de planejamento que economiza dor: monte o servidor já em PHP 8.4. É a única versão que roda tanto o 2.4.8 quanto o 2.4.9, então você migra e atualiza sem trocar o PHP no meio do caminho. E antes de mexer no metapackage, remova o tool — ele já cumpriu o papel e só vai atrapalhar o resolver. O resto do roteiro, do inventário de módulos ao dia da virada, está no guia de migração do Magento 1 para o 2.

Perguntas rápidas

Posso usar o tool 2.4.7 num Magento 2.4.8?

Não é o cenário suportado. A Adobe pede versões iguais e o mapeamento de schema muda entre linhas. Se por algum motivo não der pra usar a 2.4.8.1, o caminho honesto é fixar o destino em 2.4.7 e migrar ali, não misturar.

Depois que eu atualizar para 2.4.9, dá pra rodar o migrate:delta de novo?

Não, porque o tool não fica instalado. O delta serve para a janela entre a carga inicial e a virada do DNS, e essa janela acontece toda com o destino em 2.4.8. Só faça o upgrade depois que a loja velha estiver desligada.

E se a Adobe lançar o tool 2.4.9 daqui a pouco?

Aí o caminho fica mais curto: você monta direto em 2.4.9 e migra. Antes de começar qualquer projeto, olhe a página de releases do repositório do tool no GitHub, que é onde as tags aparecem primeiro.

Pra conferir na fonte

  1. Install the Data Migration Tool — Adobe Experience League
  2. magento/data-migration-tool releases — GitHub
  3. data-migration-tool 2.4.8.1 composer.json — GitHub
  4. Adobe Commerce e Magento Open Source: versões e datas — Adobe Experience League

migracao composer magento-1

Precisa de um orçamento? Ficarei feliz em ajudar. Clique Aqui