Felsöka vanliga byggproblem i Azure Spring Apps

  • Artikel

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för:❌ Basic/Standard ✔️ Enterprise

Den här artikeln beskriver hur du felsöker byggproblem med din Azure Spring Apps-distribution.

Skapa slutkoder

Azure Spring Apps Enterprise-planen använder Tanzu Buildpacks för att omvandla din programkällkod till bilder. Mer information finns i Tanzu Buildpacks.

När du distribuerar din app i Azure Spring Apps med hjälp av Azure CLI visas en bygglogg i Azure CLI-konsolen. Om bygget misslyckas visar Azure Spring Apps en slutkod och ett felmeddelande i CLI-konsolen som anger varför buildpack-körningen misslyckades under olika faser i buildpack-livscykeln.

I följande lista beskrivs några vanliga slutkoder:

  • 20 – Det gick inte att identifiera alla buildpack-grupper.

    Tänk på följande möjliga orsaker till en slutkod på 20:

    • Den byggare som du använder stöder inte det språk som ditt projekt använde.

      Om du använder standardverktyget kontrollerar du språket som standardverktyget stöder. Mer information finns i avsnittet APM-typer som stöds i Konfigurera APM-integrering och CA-certifikat.

      Om du använder den anpassade byggaren kontrollerar du om den anpassade byggarens buildpack stöder det språk som ditt projekt använde.

    • Du kör mot fel sökväg. Maven-projektets pom.xml-fil finns till exempel inte i rotsökvägen.

      Ange BP_MAVEN_POM_FILE platsen för projektets pom.xml fil.

    • Det är något fel med ditt program. Din .jar-fil har till exempel inte ett /META-INF/MANIFEST. MF-fil som innehåller en Main-Class post.

  • 51 – Buildpack-byggfel.

    Tänk på följande möjliga orsaker till en slutkod på 51:

    • Om Azure Spring Apps visar felmeddelandet Build failed in stage build with reason OOMKilled i Azure CLI-konsolen misslyckades bygget på grund av otillräckligt minne.

      Använd följande kommando för att öka minnet med hjälp av build-memory miljövariabeln:

      az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-app-name> \
    --build-memory 3Gi

    • Bygget misslyckades på grund av ett fel i programmets källkod. Det finns till exempel ett kompileringsfel i källkoden.

      Kontrollera byggloggen för att hitta rotorsaken.

    • Bygget misslyckades på grund av ett nedladdningsberoendefel. Ett nätverksproblem gjorde till exempel att nedladdningen av Maven-beroendet misslyckades.

    • Bygget misslyckades på grund av en JDK-version som inte stöds. JAR-filen har till exempel kompilerats med andra versioner än Java LTS, som inte stöds av buildpacken. För versioner som stöds, se avsnittet Distribuera Java-program i Så här distribuerar du flerspråkiga appar i Azure Spring Apps Enterprise-planen.

  • 62 – Det gick inte att skriva avbildningen till Azure Container Registry.

    Tänk på följande möjliga orsak till en slutkod på 62:

    • Om Azure Spring Apps visar felmeddelandet Failed to write image to the following tags i byggloggen misslyckades bygget på grund av ett nätverksproblem.

      Försök att åtgärda problemet igen.

Om ditt program är en statisk fil eller ett dynamiskt klientdelsprogram som hanteras av en webbserver kan du läsa avsnittet Vanliga bygg- och distributionsfel i Distribuera webbstatiska filer.

Nästa steg