Freigeben über

Behandlung von häufigen Build-Problemen in Azure Spring Apps

  • Artikel

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von drei Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Plan Standardverbrauch und dediziert gilt ab dem 30. September 2024 als veraltet und wird nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren des Plans „Standardverbrauch und dediziert“ von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für: ❎ Basic/Standard ✅ Enterprise

In diesem Artikel wird beschrieben, wie Sie Buildprobleme mit Ihrer Azure Spring Apps-Bereitstellung beheben.

Exitcodes von Builds

Der Azure Spring Apps Enterprise-Plan verwendet Tanzu-Buildpakete, um den Quellcode Ihrer Anwendung in Images zu transformieren. Weitere Informationen finden Sie unter Tanzu-Buildpacks.

Wenn Sie Ihre App mithilfe der Azure CLI in Azure Spring Apps bereitstellen, sehen Sie ein Buildprotokoll in der Azure CLI-Konsole. Wenn der Build nicht erfolgreich ist, zeigt Azure Spring Apps einen Exitcode und eine Fehlermeldung in der CLI-Konsole mit einem Hinweis an, warum die Buildpackausführung in verschiedenen Phasen des Buildpack-Lebenszyklus nicht erfolgreich war.

In der folgenden Liste werden einige häufige Exitcodes beschrieben:

  • 20: Keine Buildpackgruppen wurden erkannt.

    Berücksichtigen Sie die folgenden möglichen Ursachen für den Exitcode 20:

    • Der von Ihnen verwendete Generator unterstützt nicht die von Ihrem Projekt verwendete Sprache.

      Wenn Sie den Standard-Generator verwenden, überprüfen Sie die vom Standard-Generator unterstützte Sprache. Weitere Informationen finden Sie im Abschnitt Unterstützte APM-Typen unter Konfigurieren der APM-Integration und der ZS-Zertifikate.

      Wenn Sie den benutzerdefinierten Generator verwenden, überprüfen Sie, ob das Buildpack Ihres benutzerdefinierten Generators die Sprache Ihres Projekts unterstützt.

    • Sie verwenden den falschen Pfad. Die Datei pom.xml Ihres Maven-Projekts befindet sich beispielsweise nicht im Stammpfad.

      Legen Sie BP_MAVEN_POM_FILE fest, um den Speicherort der Datei pom.xml des Projekts anzugeben.

    • Mit Ihrer Anwendung stimmt etwas nicht. Beispielsweise enthält Ihre JAR-Datei keine Datei vom Typ /META-INF/MANIFEST.MF, die einen Main-Class-Eintrag enthält.

  • 51: Buildpack-Buildfehler

    Berücksichtigen Sie die folgenden möglichen Ursachen für den Exitcode 51:

    • Wenn Azure Spring Apps die Fehlermeldung Build failed in stage build with reason OOMKilled in der Azure CLI-Konsole anzeigt, ist beim Build aufgrund von unzureichendem Speicher ein Fehler aufgetreten.

      Verwenden Sie den folgenden Befehl, um den Speicher mithilfe der Umgebungsvariablen build-memory zu vergrößern:

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

    • Der Build war aufgrund eines Quellcodefehlers der Anwendung nicht erfolgreich. Beispielsweise liegt im Quellcode ein Kompilierungsfehler vor.

      Überprüfen Sie das Buildprotokoll, um die Grundursache zu ermitteln.

    • Der Build war aufgrund eines Fehlers beim Abhängigkeitsdownload nicht erfolgreich. Beispielsweise führte ein Netzwerkproblem dazu, dass der Download von Maven-Abhängigkeiten fehlschlug.

    • Der Build schlägt aufgrund einer nicht unterstützten JDK-Version fehl. Die JAR-Datei wurde beispielsweise mit Nicht-Java LTS-Versionen kompiliert, die vom Buildpaket nicht unterstützt werden. Unterstützte Versionen finden Sie im Abschnitt Bereitstellen von Java-Anwendungen unter Bereitstellen von Polyglot-Apps im Azure Spring Apps Enterprise-Plan.

  • 62:Fehler beim Schreiben des Images in Azure Container Registry

    Berücksichtigen Sie die folgenden möglichen Ursachen für den Exitcode 62:

    • Wenn Azure Spring Apps die Fehlermeldung Failed to write image to the following tags im Buildprotokoll anzeigt, war der Build aufgrund eines Netzwerkproblems nicht erfolgreich.

      Wiederholen Sie den Vorgang, um das Problem zu beheben.

Wenn Ihre Anwendung eine statische Datei oder eine dynamische Front-End-Anwendung auf einem Webserver ist, lesen Sie den Abschnitt Häufige Build- und Bereitstellungsfehler unter Bereitstellen von statischen Webdateien.

Nächste Schritte