Documentação

Solução de problemas de erros da ferramenta de compatibilidade de atualização

17 de junho de 2025

Este artigo explica os erros que você pode encontrar ao usar a Ferramenta de compatibilidade de atualização e oferece soluções para garantir uma execução bem-sucedida.

Descrição

Ambiente

Versões do Adobe Commerce a partir da versão 2.3.0

​1. Erro de falha de segmentação

Causa: Quando dois módulos têm o mesmo nome, a Ferramenta de Compatibilidade de Atualização mostra um erro de falha de segmentação.

2. Saída vazia

Etapas a serem reproduzidas:

  1. Se, após a execução deste comando bash:

    bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
    
  2. A única saída é Upgrade compatibility tool:

    bin/uct upgrade:check /var/www/project/magento/ -c 2.4.1
    Upgrade compatibility tool
    

Causa:

A causa provável é uma limitação de memória do PHP.

Existem duas soluções possíveis para evitar esta limitação de memória PHP.

Resolução

Solução para Erro de Falha de Segmentação:

Para evitar esse erro, é recomendável especificar o caminho para o módulo como um argumento:

```bashbin/uct upgrade:check --current-version=2.4.4 path/to/the/module```

Aviso: Talvez a Ferramenta de Compatibilidade de Atualização não possa analisar a base de código se ela contiver dependência circular entre métodos.

Soluções para Saída Vazia:

Solução 1:

Substitua a limitação de memória definindo memory_limit como -1:

php -d memory_limit=-1 /bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION

Observação: M2_VERSION é a versão de destino do Adobe Commerce que você deseja comparar à sua instância do Adobe Commerce.

Solução 2:

Adicionar a opção -m permite que a Ferramenta de Compatibilidade de Atualização analise cada módulo específico de maneira independente para evitar encontrar dois módulos com o mesmo nome na instância do Adobe Commerce.

Essa opção de comando também permite que a Ferramenta de compatibilidade de atualização analise uma pasta que contém vários módulos:

bin/uct upgrade:check /<dir>/<instance-name> -m /vendor/<vendor-name>/

Leitura relacionada

  • Ferramenta de Compatibilidade de Atualização
  • Execute a ferramenta em uma interface de linha de comando para obter mais informações sobre opções de interface de linha de comando
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f