Documentazione

Risolvere i problemi relativi agli errori dello strumento di compatibilità per l'aggiornamento

Ultimo aggiornamento: 4 luglio 2025

Questo articolo illustra gli errori che si possono verificare durante l’utilizzo di Upgrade Compatibility Tool e offre soluzioni per garantire un’esecuzione corretta.

Descrizione

Ambiente

Versioni di Adobe Commerce a partire dalla versione 2.3.0

​1. Errore di segmentazione

Causa: Quando due moduli hanno lo stesso nome, lo strumento di compatibilità per l'aggiornamento mostra un errore di segmentazione.

2. Output vuoto

Passaggi da riprodurre:

  1. Se dopo aver eseguito questo comando bash:

    bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
    
  2. L'unico output è Upgrade compatibility tool:

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

Causa:

La probabile causa è una limitazione della memoria PHP.

Esistono due possibili soluzioni per evitare questa limitazione della memoria PHP.

Risoluzione

Errore soluzione per errore segmentazione

Per evitare questo errore, si consiglia di specificare il percorso del modulo come argomento:

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

Avviso: lo strumento di compatibilità per l'aggiornamento potrebbe non essere in grado di analizzare la base di codice se contiene una dipendenza circolare tra i metodi.

Soluzioni per output vuoto

Soluzione 1:

Ignorare la limitazione di memoria impostando memory_limit su -1:

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

Nota: M2_VERSION è la versione Adobe Commerce di destinazione che desideri confrontare con la tua istanza Adobe Commerce.

Soluzione 2:

L'aggiunta dell'opzione -m consente a Upgrade Compatibility Tool di analizzare ogni modulo specifico in modo indipendente per evitare di incontrare due moduli con lo stesso nome nell'istanza Adobe Commerce.

Questa opzione di comando consente inoltre a Upgrade Compatibility Tool di analizzare una cartella contenente diversi moduli:

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

Lettura correlata

  • Strumento di compatibilità aggiornamento
  • Eseguire lo strumento in un'interfaccia della riga di comando per ulteriori informazioni sulle opzioni dell'interfaccia della riga di comando
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f