Zum Inhalt springen

Prozess mit Exit-Code 1 beendet: So debuggen Sie

Zuletzt aktualisiert am

Error: Process completed with exit code 1. ist nicht der eigentliche Fehler. GitHub meldet damit, dass ein Befehl in einem run-Schritt einen Status ungleich null zurückgegeben hat und der Schritt fehlgeschlagen ist. Die Ursache steht in den Logzeilen darüber. Diese Seite zeigt, wie Sie diese Zeilen finden, den Fehler reproduzieren und welche Ursachen am häufigsten auftreten.

Die genaue Meldung

Error: Process completed with exit code 1.

Exit-Code 1 ist der allgemeine Status für „etwas ist schiefgelaufen". Viele Tools verwenden ihn: Test-Runner, wenn ein Test fehlschlägt, Linter, wenn sie Probleme finden, grep, wenn kein Treffer gefunden wird, npm, wenn ein Skript fehlschlägt. Andere Codes haben spezifischere Bedeutungen, etwa 137, 143, 127 und 128.

Schritt 1: Den eigentlichen Fehler finden

Klappen Sie den fehlgeschlagenen Schritt auf und lesen Sie von der roten Zeile aus nach oben. Die erste Meldung, die wie ein Fehler aussieht (ein Stack-Trace, ein fehlgeschlagener Test, npm ERR!, error:), ist die Ursache. Ist das Log lang, nutzen Sie das Suchfeld des Log-Viewers für error, fail und fatal.

Falls nichts Hilfreiches dabei ist, aktivieren Sie Debug-Logging. Starten Sie den Job erneut und setzen Sie den Haken bei „Enable debug logging", oder setzen Sie das Repository-Secret bzw. die Variable ACTIONS_STEP_DEBUG auf true. In Shell-Schritten lassen Sie jeden Befehl beim Ausführen ausgeben:

- name: Build
  run: |
    set -x
    npm ci
    npm run build

Schritt 2: Verstehen, wie GitHub Ihr Skript ausführt

Wenn shell: bash explizit gesetzt ist, führt GitHub bash --noprofile --norc -eo pipefail {0} aus. Ohne shell-Angabe unter Linux wird bash -e {0} ausgeführt. In beiden Fällen stoppt der Schritt beim ersten fehlschlagenden Befehl, und mit pipefail lässt ein Fehler irgendwo in einer Pipeline den gesamten Schritt scheitern. Der Exit-Code des Schritts ist der Code des fehlgeschlagenen Befehls.

Häufige Ursachen und Lösungen

1. Ein Test-, Lint- oder Build-Befehl ist fehlgeschlagen

Der häufigste Fall. Führen Sie denselben Befehl lokal aus, mit derselben Node-, Python- oder Java-Version wie im Workflow, und beheben Sie, was er meldet.

2. Die Lockfile passt nicht

npm ci schlägt mit Exit-Code 1 fehl, wenn package-lock.json und package.json nicht übereinstimmen. Erzeugen Sie die Lockfile lokal mit npm install neu, committen Sie sie und verwenden Sie in der CI dieselbe Version des Paketmanagers.

3. grep oder diff haben nichts oder etwas gefunden

grep endet mit 1, wenn es keinen Treffer gibt, und diff endet mit 1, wenn sich Dateien unterscheiden. Beides sind normale Ergebnisse, die den Schritt trotzdem fehlschlagen lassen. Wenn ein fehlender Treffer akzeptabel ist, sagen Sie das ausdrücklich:

- run: grep -q "ready" status.txt || echo "not ready yet"

Hängen Sie || true nicht an einen Befehl an, dessen Fehlschlag wichtig ist, denn so werden echte Fehler verborgen.

4. Eine fehlende Umgebungsvariable oder ein fehlendes Secret

Secrets sind in Workflows, die aus Forks ausgelöst werden, und in manchen Dependabot-Läufen leer, und Skripte, die sie benötigen, schlagen dann fehl. Geben Sie aus, ob sie gesetzt sind, ohne den Wert auszugeben:

- run: test -n "$API_TOKEN" || { echo "API_TOKEN is empty"; exit 1; }
  env:
    API_TOKEN: ${{ secrets.API_TOKEN }}

5. Es funktioniert lokal, aber nicht in der CI

Unterschiedliche Tool-Versionen, ein anderes Betriebssystem oder case-sensitive Dateinamen. Fixieren Sie Versionen mit setup-node, setup-python oder setup-java und prüfen Sie, ob die Import-Pfade der tatsächlichen Groß- und Kleinschreibung der Dateinamen entsprechen.

Wenn ein Fehlschlag erwartet wird

Verwenden Sie continue-on-error: true bei einem Schritt nur dann, wenn Sie wirklich nicht möchten, dass er den Job fehlschlagen lässt, und prüfen Sie das Ergebnis später über steps.<id>.outcome.

So verhindern Sie den Fehler

  1. Führen Sie dieselben Befehle lokal mit denselben Versionen aus, idealerweise über ein einziges Skript, das auch die CI aufruft.
  2. Fixieren Sie Laufzeit- und Tool-Versionen, anstatt flexible Versionsangaben zu verwenden.
  3. Geben Sie zu Beginn jedes Jobs die Version des fehlschlagenden Tools und das Arbeitsverzeichnis aus.
  4. Halten Sie Schritte klein, damit der fehlschlagende Schritt das Problem benennt.
  5. Verbergen Sie Fehlschläge nicht mit || true.

FAQ

Was bedeutet Exit-Code 1 in GitHub Actions?

Der Befehl hat den Status 1 zurückgegeben, den allgemeinen Fehlercode. GitHub markiert den Schritt als fehlgeschlagen. Was schiefgelaufen ist, steht in der Ausgabe oberhalb der Meldung.

Warum steht oberhalb von „exit code 1" kein Fehler?

Das Tool hat Fehler möglicherweise in eine Datei geschrieben, oder eine Log-Gruppe ist eingeklappt. Klappen Sie alle Gruppen auf, aktivieren Sie dann Debug-Logging und starten Sie den Job erneut.

Ist Exit-Code 1 dasselbe wie 0?

Nein. Exit-Code 0 bedeutet Erfolg. Jeder andere Code lässt den Schritt fehlschlagen, sofern Sie nicht continue-on-error setzen.

Kann ich einen Schritt Exit-Code 1 ignorieren lassen?

Ja, mit continue-on-error: true oder durch die Behandlung des Befehls im Skript. Tun Sie das nur, wenn der Fehler wirklich keine Rolle spielt.