Solução de problemas do Commerce Version Tool

Use esta página para solucionar problemas comuns do Commerce Version Tool (CVT) com detecção do Composer, carregamento do Registro, detecção interna de patch de execução seca, geração de saída e registro de auditoria.

Etapas rápidas de solução de problemas

Se a ferramenta CVT não retornar o relatório de status de patch esperado:

Problemas comuns e soluções

A versão base não pode ser detectada

Se a ferramenta CVT não puder localizar a versão base do Adobe Commerce, verifique estas condições:

Verificar:

Mensagens de aviso:

Se composer.lock existir, mas for ilegível, não analisável ou não contiver um pacote base reconhecido, a ferramenta emitirá uma das seguintes cadeias de caracteres no campo de saída avisos:

No recognized Commerce base package found in composer.lock
composer.lock exists but could not be read
composer.lock could not be parsed as JSON

Qualquer uma das condições mencionadas anteriormente indica que a ferramenta não pode detectar a versão base. A ferramenta sai com o código 1 e nenhuma detecção de patch é executada.

Ações:

Nenhum patch se aplica à versão instalada

Se CVT relatar um base_version válido, mas applied_patches, missing_patches e unknown_patches estiverem vazios, a versão instalada não será coberta pelo Registro de patch atual.

Verificar:

Mensagens de aviso:

No patches found in registry for installed component versions (CE=2.4.7-p9)

Este aviso é diferente de “A versão base não pode ser detectada”. O base_version está correto, a ferramenta existe 0 e não há nada no Registro para comparação.

Ações:

O registro de patch não pode ser obtido

Se a ferramenta CVT não puder obter o arquivo de registro de patch mais recente, verifique as configurações de rede e cache:

Verificar:

Mensagens de aviso:

A ferramenta emite as seguintes cadeias de caracteres no campo de saída de avisos para este cenário:

Remote registry fetch failed (HTTP 403). Check PATCH_REGISTRY_URL (if set) and network connectivity.
Remote registry response was not valid JSON; ignoring.
Could not load remote registry. Using cached registry (3 hours old). CVE coverage may be incomplete.
Patch registry could not be loaded.
Could not fetch remote registry and --no-cache was set; aborting.

A mensagem de cache obsoleta inclui a idade real em horas, por exemplo, (3 hours old).

Os avisos patch registry could not be loaded e could not fetch remote registry indicam que a ferramenta saiu sem executar a detecção de patch.

Ações:

Não é possível buscar ou verificar a diferença entre patches

Se a ferramenta CVT não puder testar um ou mais patches aplicáveis, verifique o acesso de comparação de patches:

Verificar:

Mensagens de aviso:

A ferramenta emite as seguintes cadeias de caracteres no campo de saída de avisos para este cenário:

Patch 247p9-2026-05-001-EE requires authentication. Set credentials via COMPOSER_AUTH or auth.json.
Could not fetch patch 247p9-2026-05-001-EE (HTTP 401). Check credentials (COMPOSER_AUTH / auth.json).
Could not fetch patch 247p9-2026-05-001-EE (HTTP 404).
Could not fetch or verify patch 247p9-2026-05-001-EE. Check network connectivity and credentials (COMPOSER_AUTH / auth.json).
Could not fetch patch file for 247p9-2026-05-001-EE.
SHA-256 verification failed for patch 247p9-2026-05-001-EE; discarding download.

A ID do patch em cada mensagem é a ID de entrada de registro real, por exemplo 247p9-2026-05-001-EE. SHA-256 verification failed significa que um arquivo de patch recém-baixado não corresponde à soma de verificação esperada. A ferramenta o descarta sem armazenar em cache e classifica o patch unknown para essa execução. Uma entrada de cache local corrompida foi detectada e buscada silenciosamente na mesma execução sem aviso. Em ambos os casos, nenhuma limpeza manual do cache é necessária.

Ações:

Patches ausentes ou desconhecidos são reportados

Se o relatório contiver valores inesperados de missing_patches ou unknown_patches, verifique os detalhes de instalação e saída:

Verificar:

Mensagens de aviso:

A ferramenta emite as seguintes cadeias de caracteres no campo de saída de avisos para este cenário:

No file_name or sha256 for 247p9-2026-05-001-EE
Registry entry '247p9-2026-05-001-EE' requires unknown patch '247p9-2026-04-001-EE'; skipping.
descendant diffs unavailable for 247p9-2026-06-001-EE; dry-run for 247p9-2026-05-001-EE may be inaccurate
Failed to reverse-apply 247p9-2026-06-001-EE when preparing dry-run for 247p9-2026-05-001-EE; result may be inaccurate
Failed to forward-apply prerequisite 247p9-2026-04-001-EE when preparing dry-run for 247p9-2026-05-001-EE; result may be inaccurate

Quando você encontrar may be inaccurate em um aviso, a verificação de simulação ainda será executada, mas com confiança reduzida. O patch ainda pode ser categorizado em applied_patches ou missing_patches, não necessariamente unknown_patches.

Para patches desconhecidos especificamente, var/log/patch_status.log registra a saída bruta de execução seca de patch (avançar e retroceder), que indica quais arquivos e partes falharam na correspondência.

Se você encontrar um aviso “Nenhum patch encontrado”, consulte nenhum patch se aplica à versão instalada para obter orientação.

Ações:

Saída não gerada

Se a ferramenta CVT for concluída, mas a saída JSON ou CSV esperada estiver ausente, verifique a sintaxe do comando e a saída do terminal:

Ações:

Obtendo ajuda

Ao entrar em contato com o suporte da Adobe Commerce, forneça apenas os detalhes necessários para investigar o problema.

Incluir:

Não inclua segredos, credenciais, chaves privadas ou dados não relacionados do cliente em logs compartilhados ou anexos.

Tópicos relacionados