Zum Inhalt springen

Prozess mit Exit-Code 127 beendet: Befehl nicht gefunden

Zuletzt aktualisiert am

Process completed with exit code 127 bedeutet, dass die Shell den Befehl, den sie ausführen sollte, nicht finden konnte. Sehen Sie ein paar Zeilen weiter oben nach, ob dort command not found oder No such file or directory steht. Die Ursachen sind ein Tool, das auf dem Runner nicht installiert ist, ein PATH, der es nicht enthält, ein falscher Skriptpfad oder eine Skriptdatei mit Windows-Zeilenenden.

Die genaue Meldung

/home/runner/work/_temp/abc123.sh: line 1: pnpm: command not found
Error: Process completed with exit code 127.
./deploy.sh: No such file or directory
Error: Process completed with exit code 127.

Ursache 1: Das Tool ist auf dem Runner nicht installiert

Gehostete Images enthalten viele Tools, aber nicht alle. Prüfen Sie die Softwareliste der Runner-Images für Ihr runs-on-Label und installieren Sie fehlende Tools mit einer Setup-Action oder einem Paketmanager:

- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
  with:
    node-version: 22
    cache: pnpm
- run: pnpm install --frozen-lockfile

Für Systempakete unter Ubuntu:

- run: sudo apt-get update && sudo apt-get install -y jq

Wenn Sie von ubuntu-latest auf einen selbst gehosteten oder Drittanbieter-Runner gewechselt sind, fehlen im Image unter Umständen Tools, die im Image von GitHub enthalten sind. Vergleichen Sie vor dem Wechsel.

Ursache 2: Das Tool ist installiert, liegt aber nicht im PATH

Ein in einem Schritt installiertes Tool liegt im nächsten Schritt nicht im PATH, sofern Sie sein Verzeichnis nicht in die Datei GITHUB_PATH eintragen. Verwenden Sie dafür nicht export PATH=..., da dies nur den aktuellen Schritt betrifft:

- run: |
    curl -fsSL https://example.com/tool.tar.gz | tar xz -C "$HOME/tool"
    echo "$HOME/tool/bin" >> "$GITHUB_PATH"
- run: tool --version

Ursache 3: Falscher Skriptpfad oder fehlendes Ausführungsrecht

./script.sh: No such file or directory und Permission denied bedeuten, dass der Pfad relativ zum Arbeitsverzeichnis falsch ist oder die Datei nicht ausführbar ist. Prüfen Sie working-directory und machen Sie die Datei in Git ausführbar:

chmod +x scripts/deploy.sh
git update-index --chmod=+x scripts/deploy.sh

Alternativ rufen Sie das Skript über den Interpreter auf, der kein Ausführungsrecht benötigt: run: bash scripts/deploy.sh.

Ursache 4: Windows-Zeilenenden (CRLF)

Ein Skript mit CRLF-Zeilenenden enthält in seiner Shebang-Zeile einen versteckten Wagenrücklauf. Das System sucht dann einen Interpreter namens bash\r und meldet "No such file or directory", obwohl die Datei existiert. Konvertieren Sie sie:

sed -i 's/\r$//' scripts/deploy.sh

Damit die Datei nicht wieder mit CRLF auftaucht, legen Sie eine .gitattributes-Datei an:

*.sh text eol=lf

Ursache 5: Tippfehler oder falsche Shell

Befehlsnamen sind unter Linux case-sensitiv. Ein Schritt mit shell: pwsh führt PowerShell aus, das andere Befehle als bash verwendet, und ein Schritt mit shell: cmd kann keine bash-Syntax ausführen.

Ursache 6: Fehlende Binärdatei in einem Container-Job

Wenn ein Job container: verwendet, stammen die Tools aus diesem Image und nicht vom Runner. Verwenden Sie ein Image, das alles Nötige enthält.

So verhindern Sie den Fehler

  1. Geben Sie die Versionen zu Beginn des Jobs aus (node --version, docker --version), damit ein fehlendes Tool schnell und eindeutig fehlschlägt.
  2. Installieren Sie Tools mit fixierten Setup-Actions, statt deren Vorhandensein vorauszusetzen.
  3. Halten Sie Skripte über .gitattributes ausführbar und mit LF-Zeilenenden.
  4. Führen Sie denselben Schritt lokal in einem sauberen Container aus, um Annahmen über Ihren Rechner aufzudecken.

FAQ

Was bedeutet Exit-Code 127?

"Command not found" in POSIX-Shells. Er wird zurückgegeben, wenn die Shell das Programm nicht finden oder ausführen kann.

Warum funktioniert der Befehl auf meinem Rechner?

Auf Ihrem Rechner ist das Tool installiert und im PATH verfügbar. Ein Runner ist sauber und startet jeden Schritt in einer neuen Shell.

Was ist der Unterschied zwischen 126 und 127?

126 bedeutet, dass die Datei gefunden, aber nicht ausgeführt werden konnte, meist wegen fehlender Berechtigungen. 127 bedeutet, dass sie gar nicht gefunden wurde.

Unterscheidet sich die Einrichtung auf Windows- und macOS-Runnern?

Ja. Die Tool-Listen unterscheiden sich zwischen den Images. Prüfen Sie daher die Softwareliste für das Label, das Sie verwenden.