Dokumentation

Distributionen misslyckas med felet"Error building project: The build krok failed with status code 1"

Last update: Fri Jul 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

I den här artikeln beskrivs orsaker och lösningar till Adobe Commerce-problemet med molninfrastruktur, där distributionsprocessens byggfas misslyckas och felmeddelandet sammanfattas med: Fel när projekt byggs: Byggprocessen misslyckades med statuskod 1.

Beskrivning description

Miljö

Adobe Commerce om molninfrastruktur, alla versioner

Problem/ symtom

  • Distributionen misslyckas under byggfasen.
  • Felloggen avslutas med: Fel när projektet skapades: Byggkroken misslyckades med statuskod 1. Avbröt bygget.
  • Distributionen utlöses manuellt eller av en sammanslagning, push eller synkronisering.

Steg att återskapa:

Utlös distributionen manuellt eller genom att utföra en sammanslagning, push eller synkronisering av din miljö.

Förväntat resultat:

Distributionen har slutförts.

Faktiskt resultat:

  1. Byggfasen misslyckas och hela installationsprocessen fastnar.
  2. I distributionsfelloggen avslutas felmeddelandet med: Fel när projektet skapades: Bygge-kroken misslyckades med statuskod 1. Avbröt bygget.

Orsak

Felet är ett allmänt felmeddelande. Den verkliga orsaken visas tidigare i loggen. Vanliga orsaker:

  • Inget tillgängligt lagringsutrymme
  • Felaktig ECE-verktygskonfiguration
  • Den korrigering du försöker tillämpa är inte kompatibel med din Adobe Commerce-version eller har konflikter med andra korrigeringsfiler som används eller dina anpassningar.
  • Problem med anpassad modulkod förhindrar att det går att skapa.

Upplösning resolution

  • Kontrollera att det finns tillräckligt med lagringsutrymme. Mer information om hur du kontrollerar tillgängligt utrymme finns i artikeln Kontrollera diskutrymme i molnmiljö med CLI . Du kan överväga att rensa loggkatalogerna och/eller öka diskutrymmet.
  • Kontrollera att ECE-verktygen är korrekt konfigurerade.
  • Kontrollera om det är korrigeringen som orsakar problemet. Lös konflikten eller kontakta Adobe Commerce Support. Mer information finns nedan.
  • Kontrollera om det är det anpassade tillägg som orsakar problemet. Lös konflikten eller kontakta tilläggsutvecklarna för lösningen.

I följande stycken finns mer information.

Rengör loggar och/eller öka utrymmet

Kataloger som ska beaktas för rensning:

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

Mer information om hur du kan öka diskutrymmet om du använder Adobe Commerce för startplanens arkitektur för molninfrastruktur finns i Öka diskutrymmet för integreringsmiljön i molnet. Samma instruktioner kan användas för att öka utrymmet för Adobe Commerce i molninfrastrukturen Pro-planens integreringsmiljö. För Pro Production/Staging måste du registrera en biljett till Adobe Commerce Support och begära utökat diskutrymme. Men det övervakas av Platform. I vanliga fall behöver du inte hantera detta när Adobe Commerce övervakar parametrarna och meddelar dig och/eller vidtar åtgärder enligt avtalet.

Kontrollera att ECE-verktygen är korrekt konfigurerade

  1. Kontrollera att build-hooks har definierats korrekt i filen magento.app.yaml. Om du använder Adobe Commerce 2.2.X bör du definiera byggkrokar enligt följande:

    code language-none 
    # We run build hooks before your application has been packaged.
build: |
    php ./vendor/bin/ece-tools build
# We run deploy hook after your application has been deployed and started.
deploy: |
    php ./vendor/bin/ece-tools deploy

    Använd artikeln Uppgradera till ece-tools som referens.

  2. Kontrollera att ECE-verktygspaketet finns i filen Composer.lock genom att köra följande kommando:

    code language-none 
    grep '"name": "magento/ece-tools"' composer.lock

    Om de anges ser svaret ut som i följande exempel:

    code language-none 
    "name": "magento/ece-tools", "version": "2002.0.20",

    Referens finns i artikeln Uppgradera till delade verktyg.

Orsakar korrigeringen problemet?

Om det är den tillämpade korrigeringen som förhindrar miljön från att skapas korrekt, kommer du att se något liknande i distributionsloggen:

%patch_name%.composer.patch
[ 2019-02-19 18:12:59]  CRITICAL:
....
[ 2019-02-19 18:12:59]  CRITICAL: Command git apply --check --reverse /app/m2-hotfixes/%patch_name%.composer.patch returned code 1
...
W:
W: Command git apply --check --reverse /app/m2-hotfixes/%patch_name%.composer.patch returned code 1
W:
W:
W: build
...
E: Error building project: The build hook failed with status code 1. Aborted build.

Dessa felmeddelanden innebär att den korrigering du försöker tillämpa antingen har skapats för en annan version av Adobe Commerce eller är i konflikt med dina anpassningar eller tidigare tillämpade korrigeringar. Försök att lösa konflikten eller kontakta Adobe Commerce Support.

Är tillägget orsaken till problemet?

Om det är det anpassade tillägg som förhindrar att miljön kan byggas ut visas namnen på de anpassade modulerna i distributionsloggen tillsammans med den särskilda konflikt som den här modulen orsakat. Lös konflikten eller kontakta tilläggsutvecklarna för lösningen.

Se till att ändringarna tillämpas

Verkställ och push-styr ändringarna. Detta utlöser distributionen automatiskt.

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