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

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 description

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:

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

    code language-none
    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 resolution

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:

bin/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

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f