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 tool | Publicada em |
|---|---|
2.4.8.1 | 03/06/2025 |
2.4.7 | 09/04/2024 |
2.4.6.1 | 29/08/2023 |
2.4.6 | 14/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:
| Pacote | symfony/console | PHP |
|---|---|---|
| Magento 2.4.8 | ^6.4 | 8.2, 8.3, 8.4 |
| Magento 2.4.9 | ^7.4 | 8.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 lojaSe 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:upgradeDescer 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:upgradeConfirme o que entrou antes de continuar:
composer show magento/data-migration-tool | head -3
php bin/magento list | grep migrateVocê 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:compileUm 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
- Install the Data Migration Tool — Adobe Experience League
- magento/data-migration-tool releases — GitHub
- data-migration-tool 2.4.8.1 composer.json — GitHub
- Adobe Commerce e Magento Open Source: versões e datas — Adobe Experience League