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: 17 marzo 2025

Creato per:

  • Sviluppatore

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".

Prodotti e versioni interessati

  • Adobe Commerce su infrastruttura cloud, tutte le versioni

Problema

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 compilazione del progetto: hook di compilazione non riuscito con codice di stato 1. Build interrotta".

Causa

Ci sono diversi motivi per cui la creazione dell’ambiente non riesce. In genere, nel registro di distribuzione viene visualizzato un lungo messaggio di errore, in cui la prima parte è più specifica per il motivo e la conclusione è "Errore durante la creazione del progetto: hook di compilazione non riuscito con codice di stato 1. Build interrotta".

Osservando più da vicino la prima parte specifica del problema sarà utile identificare il problema. Di seguito sono elencate le più comuni e la sezione successiva fornisce le relative soluzioni:

  • Spazio di archiviazione non 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.

Soluzione

  • 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.