Exit-Codes verstehen: Effektive Fehlerbehandlung mit $? und exit

Wenn ein Bash-Skript fehlschlägt, teilt der Exit-Code dem Aufrufer mit, was als Nächstes passieren soll: fortsetzen, wiederholen, alarmieren oder anhalten. Das Verständnis von Exit-Codes, $? und exit ist der Unterschied zwischen Automatisierung, die Fehler verbirgt, und Automatisierung, die sie klar meldet.

Diese Anleitung zeigt, wie Bash den Befehlsstatus verfolgt und wie Sie diesen Status für eine einfache, zuverlässige Fehlerbehandlung nutzen können.

Das Konzept der Exit-Status

Jeder Befehl oder jedes Programm, das in einer Unix-ähnlichen Shell-Umgebung ausgeführt wird – sei es ein eingebauter Befehl wie cd, ein externes Dienstprogramm wie grep oder ein anderes Shell-Skript – gibt nach Abschluss einen ganzzahligen Wert zurück. Diese ganze Zahl ist der Exit-Code, der dem aufrufenden Prozess das Ergebnis der Operation signalisiert.

Die Standardkonvention

Die Konvention für Exit-Codes ist allgemein anerkannt:

• 0 (Null): Bedeutet Erfolg. Der Befehl wurde genau wie erwartet ausgeführt, und es sind keine Fehler aufgetreten.
• 1 bis 255: Bedeuten Fehler oder spezifische Fehlerbedingungen. Diese Werte ungleich Null zeigen an, dass etwas schief gelaufen ist. Höhere Zahlen entsprechen oft bestimmten Fehlertypen (z. B. Datei nicht gefunden, Zugriff verweigert, Syntaxfehler), obwohl die genaue Bedeutung vom jeweiligen Programm abhängt.

Hinweis zum Bereich: Obwohl Exit-Codes technisch gesehen ein 8-Bit-Wert (0-255) sind, kümmern sich Shell-Skripte normalerweise nur um 0 für Erfolg und ungleich Null für Fehler. Exit-Codes größer als 255 werden normalerweise von der Shell abgeschnitten oder modulo 256 interpretiert.

Überprüfen des letzten Exit-Codes: Die Variable $?

Die spezielle Shell-Variable $? (Dollar-Fragezeichen) ist zentral für die Überwachung des Befehlsstatus. Unmittelbar nach der Ausführung eines Befehls speichert die Shell seinen Exit-Code in $?.

So verwenden Sie $?

Sie müssen $? unmittelbar nach dem Befehl überprüfen, an dem Sie interessiert sind, da jeder nachfolgende Befehl (selbst das Echo der Variable) seinen Wert überschreibt.

Beispiel 1: Erfolg und Fehler überprüfen

# 1. Ein erfolgreicher Befehl
echo "Erfolgstest" > /dev/null
echo "Exit-Code für Erfolg: $?"

# 2. Ein fehlschlagender Befehl (z. B. versuchen, eine nicht vorhandene Datei aufzulisten)
ls /nicht/vorhandener/pfad
echo "Exit-Code für Fehler: $?"

Erwartete Ausgabe:

Exit-Code für Erfolg: 0
ls: Zugriff auf '/nicht/vorhandener/pfad' nicht möglich: Datei oder Verzeichnis nicht gefunden
Exit-Code für Fehler: 2

Implementieren einer bedingten Fehlerprüfung

Allein das Wissen um den Exit-Code reicht nicht aus; die Stärke liegt darin, diese Informationen zur Steuerung des Skriptablaufs zu nutzen. Dies geschieht typischerweise mit if-Anweisungen oder Kurzschlussoperatoren (&& und ||).

Verwenden von if-Anweisungen

Dies ist die expliziteste Methode zur Fehlerbehandlung:

if grep -q "wichtige daten" logdatei.txt;
then
    echo "Daten erfolgreich gefunden."
else
    LETZTER_STATUS=$?
    echo "Fehler: grep fehlgeschlagen mit Status $LETZTER_STATUS. Daten nicht gefunden."
    # Erwägen Sie, hier zu beenden, wenn das Skript nicht fortgesetzt werden kann
fi

Im obigen Beispiel unterdrückt grep -q die Ausgabe (-q) und gibt nur dann 0 zurück, wenn eine Übereinstimmung gefunden wird. Die if-Struktur überprüft den Exit-Status automatisch, aber das explizite Erfassen von $? innerhalb des else-Blocks ist für eine detaillierte Protokollierung nützlich.

Verwenden von Kurzschlusslogik (&& und ||)

Für einfache sequentielle Prüfungen bieten Kurzschlussoperatoren eine prägnante Fehlerbehandlung:

• && (UND): Der Befehl nach && wird nur ausgeführt, wenn der vorhergehende Befehl erfolgreich war (0 zurückgegeben hat).
• || (ODER): Der Befehl nach || wird nur ausgeführt, wenn der vorhergehende Befehl fehlgeschlagen ist (einen Wert ungleich Null zurückgegeben hat).

Beispiel 2: Prägnante Fehlerbehandlung

# 1. Führe 'process_data' NUR aus, wenn 'fetch_data' erfolgreich ist
fetch_data.sh && ./process_data.sh

# 2. Führe 'send_alert' NUR aus, wenn die primäre Operation fehlschlägt
rsync -a quelle/ ziel/ || echo "RSync fehlgeschlagen am $(date)" >> /var/log/rsync_fehler.log

Steuern der Skriptbeendigung mit exit

Der Befehl exit wird verwendet, um das aktuelle Shell-Skript oder die aktuelle Funktion sofort zu beenden und einen bestimmten Exit-Status an den Aufrufer zurückzugeben (der ein anderes Skript oder das Terminal des Benutzers sein kann).

Syntax und Verwendung

Die Syntax ist einfach exit [status_code].

Wenn kein Status angegeben wird, verwendet exit standardmäßig den Status des zuletzt ausgeführten Vordergrundbefehls. Wenn Sie explizit exit 0 aufrufen, ohne zuvor einen Befehl auszuführen, wird 0 zurückgegeben.

Beispiel 3: Beenden bei Fehler einer Vorbedingung

Dieses Skript stellt sicher, dass eine erforderliche Konfigurationsdatei vorhanden ist, bevor es fortfährt.

KONFIG_DATEI="/etc/app/config.conf"

if [[ ! -f "$KONFIG_DATEI" ]]; then
    echo "Fehler: Konfigurationsdatei nicht gefunden unter $KONFIG_DATEI."
    # Skript sofort mit einem bestimmten Fehlercode beenden (z. B. 20)
    exit 20 
fi

echo "Konfiguration geladen. Skript wird fortgesetzt..."
# ... Rest des Skripts
exit 0

Best Practice: Verwendung aussagekräftiger Exit-Codes

Während 0 und 1 die meisten grundlegenden Fälle abdecken, hilft die Verwendung verschiedener Codes ungleich Null dem aufrufenden Skript, das genaue Problem zu diagnostizieren:

Code	Bedeutung (Beispiel)
0	Erfolg
1	Allgemeiner Sammelfehler
2-10	Syntaxfehler, Probleme bei der Argumentanalyse
20	Fehlende Voraussetzung (z. B. Datei nicht gefunden)
30	Berechtigungsproblem

Skripte schnell scheitern lassen: Der Befehl set

Für maximale Zuverlässigkeit in komplexen Skripten ist es eine starke Best Practice, die Fehlerprüfung global mit den Optionen des Befehls set am Anfang Ihres Skripts zu aktivieren:

#!/bin/bash

# Beende sofort, wenn ein Befehl mit einem Status ungleich Null beendet wird.
set -e

# Behandle nicht gesetzte Variablen als Fehler beim Ersetzen.
set -u

# Pipefail: Stellt sicher, dass der Rückgabestatus einer Pipeline der Status des am weitesten rechts stehenden Befehls ist, der mit einem Status ungleich Null beendet wurde.
set -o pipefail

# (Optional, aber hilfreich) Gib Befehle während der Ausführung zu Debugging-Zwecken aus
# set -x 

# Wenn einer der folgenden Befehle fehlschlägt, wird das Skript sofort gestoppt.
ls /gültiger/pfad && grep muster datei.txt && ./nächster_schritt.sh

# Die folgende Zeile wird NUR ausgeführt, wenn alle vorhergehenden Befehle erfolgreich waren.
echo "Alle Schritte abgeschlossen."

Wenn set -e aktiv ist, stoppen viele nicht behandelte Status ungleich Null das Skript, bevor spätere Befehle auf der Grundlage falscher Annahmen ausgeführt werden. Es gibt Ausnahmen in Bedingungen, Pipelines und zusammengesetzten Befehlen, also behandeln Sie erwartete Fehler weiterhin explizit.

Zum Beispiel gibt grep 1 zurück, wenn es keine Übereinstimmung findet. Das kann ein normales Ergebnis sein, kein fataler Fehler:

if grep -q "BEREIT" status.txt; then
    echo "Dienst ist bereit."
else
    echo "Dienst ist noch nicht bereit."
fi

Fazit

Überprüfen Sie kritische Befehle dort, wo sie ausgeführt werden, schreiben Sie Fehler nach stderr und beenden Sie mit einem Status ungleich Null, wenn das Skript nicht sicher fortgesetzt werden kann. Verwenden Sie set -euo pipefail für Fail-Fast-Skripte, verlassen Sie sich jedoch nicht darauf als Ihre einzige Fehlerbehandlungsstrategie.