La distribuzione non riesce e viene visualizzato il messaggio "Errore durante la creazione del progetto: hook di compilazione non riuscito con codice di stato 1"

Ultimo aggiornamento: 18 giugno 2025

In questo articolo vengono illustrate le cause e le soluzioni del problema relativo all'infrastruttura cloud di Adobe Commerce, in cui la fase di compilazione del processo di distribuzione non riesce e il messaggio di errore viene riepilogato con: Errore durante la compilazione del progetto: hook di compilazione non riuscito con codice di stato 1.

Descrizione

Ambiente

Adobe Commerce su infrastruttura cloud, tutte le versioni

Problema/sintomi

  • L’implementazione non riesce durante la fase di build.
  • Il log degli errori termina con: Errore durante la generazione del progetto: hook di compilazione non riuscito con codice di stato 1. Compilazione interrotta.
  • L’implementazione viene attivata manualmente o da un’unione, un push o una sincronizzazione.

Passaggi da riprodurre:

Attiva la distribuzione manualmente o eseguendo un’unione, un push o una sincronizzazione dell’ambiente.

Risultato previsto:

Distribuzione completata correttamente.

Risultato effettivo:

  1. La fase di costruzione non riesce e l’intero processo di distribuzione si blocca.
  2. Nel log degli errori di distribuzione, il messaggio di errore termina con: Errore durante la creazione del progetto: hook di compilazione non riuscito con codice di stato 1. Compilazione interrotta.

Causa

L’errore è un messaggio di errore generico. La causa effettiva viene visualizzata prima nel registro. Le cause più comuni includono:

  • Nessuno spazio di archiviazione disponibile
  • Configurazione ECE-Tools errata
  • La patch che stai tentando di applicare non è compatibile con la versione di Adobe Commerce in uso o presenta conflitti con altre patch applicate o con le tue personalizzazioni.
  • Problemi con il codice dei moduli personalizzati impediscono la corretta generazione.

Risoluzione

  • Verifica che lo spazio di archiviazione sia sufficiente. Per informazioni su come verificare lo spazio disponibile, vedere l'articolo Controllare lo spazio su disco nell'ambiente cloud utilizzando CLI. È possibile pulire le directory di registro e/o aumentare lo spazio su disco.
  • Assicurati che gli strumenti ECE siano configurati correttamente.
  • Controllare se il problema è causato dalla patch. Risolvere il conflitto o contattare il Supporto Adobe Commerce. Per ulteriori informazioni, consulta di seguito.
  • Verifica se è l’estensione personalizzata a causare il problema. Risolvi il conflitto o contatta gli sviluppatori di estensioni per la soluzione.

I paragrafi seguenti forniscono ulteriori dettagli.

Pulire i registri e/o aumentare lo spazio disponibile

Directory da considerare per la pulizia:

  • var/log
  • var/report
  • var/debug/
  • var

Per informazioni dettagliate su come aumentare lo spazio su disco se si utilizza l'architettura del piano Starter per l'infrastruttura cloud di Adobe Commerce, vedere Aumentare lo spazio su disco per l'ambiente di integrazione nel cloud. Le stesse istruzioni possono essere utilizzate per aumentare lo spazio di Adobe Commerce sull’infrastruttura cloud Ambiente di integrazione dell’architettura Pro plan. Per Pro Production/Staging, è necessario inviare un ticket a Supporto Adobe Commerce e richiedere maggiore spazio su disco. Ma è monitorato da Platform. In genere, tuttavia, non è necessario occuparsi di questo problema nell’architettura di staging/produzione di Pro, in quanto Adobe Commerce monitora questi parametri per conto dell’utente e avvisa l’utente e/o esegue azioni in base al contratto.