Zum Inhalt springen

The Process '/usr/bin/git' Failed With Exit Code 128

Zuletzt aktualisiert am

The process '/usr/bin/git' failed with exit code 128 bedeutet, dass git einen schwerwiegenden Fehler hatte und angehalten wurde. Exit 128 ist der Fehlercode von git für "fatal"; der Grund steht in der fatal:-Zeile direkt darüber. Er tritt am häufigsten bei actions/checkout oder bei einem git-Befehl in einem run-Schritt auf. Die üblichen Ursachen sind Authentifizierung, eine nicht vorhandene Referenz, ein flacher Clone ohne Historie oder Dateibesitz in einem Container.

Die genaue Meldung

Error: The process '/usr/bin/git' failed with exit code 128

Lesen Sie die Zeile davor. Die häufigsten Fälle sind unten aufgeführt, jeweils mit der passenden Lösung.

fatal: could not read Username oder Authentication failed

Der Job benötigt Zugangsdaten für ein privates Repository. Siehe could not read Username und Permission denied (publickey).

fatal: repository '...' not found

Die Eingabe repository: ist falsch, das Repository wurde umbenannt oder gelöscht, oder das Token kann es nicht sehen. GitHub meldet ein privates Repository, auf das Sie keinen Zugriff haben, als "not found". Prüfen Sie die Schreibweise und die Zugriffsrechte des Tokens.

fatal: couldn't find remote ref oder pathspec ... did not match

Der angeforderte Branch, Tag oder SHA existiert in diesem Repository nicht. Das passiert, wenn ein Branch nach dem Merge eines Pull Requests gelöscht wurde, ref: auf einen veralteten Namen zeigt oder ein Tag nie gepusht wurde.

- uses: actions/checkout@v4
  with:
    ref: ${{ github.event.pull_request.head.sha }}

Bei Pull Requests aus Forks liegt der Head-Branch im Fork. Verwenden Sie daher repository: ${{ github.event.pull_request.head.repo.full_name }} zusammen mit der Referenz und beachten Sie die Sicherheitsimplikationen, wenn Fork-Code mit Secrets ausgeführt wird.

fatal: ... unknown revision nach einem flachen Clone

Standardmäßig holt actions/checkout nur einen einzelnen Commit. Befehle wie git log main..HEAD, git describe, git diff origin/main oder ein Changelog-Generator schlagen dann fehl, weil die Historie fehlt. Holen Sie mehr Historie:

- uses: actions/checkout@v4
  with:
    fetch-depth: 0   # full history and tags

fetch-depth: 0 holt die gesamte Historie, was bei großen Repositories langsamer ist. Wenn Sie nur etwas mehr benötigen, setzen Sie eine Zahl wie fetch-depth: 50 oder führen Sie git fetch --depth=200 origin main vor dem Befehl aus.

fatal: detected dubious ownership in repository

In einem Job, der in einem container: läuft, gehört das Workspace einem anderen Benutzer als dem, der git ausführt, und git verweigert die Arbeit darin. Markieren Sie es als sicher:

- run: git config --global --add safe.directory "$GITHUB_WORKSPACE"

Neuere Versionen von actions/checkout erledigen dies in den meisten Fällen automatisch. Prüfen Sie daher auch, ob Sie eine aktuelle Hauptversion verwenden.

fatal: not a git repository

Der Schritt lief vor einem Checkout oder im falschen Verzeichnis. Fügen Sie zuerst actions/checkout hinzu und prüfen Sie working-directory.

fatal: unable to access ... The requested URL returned error: 403

Das liegt meist an einem Push oder Fetch ohne die nötige Token-Berechtigung. Siehe [Permission denied to github-actions[bot]](/errors/permission-to-repo-denied-to-github-actions-bot).

Submodule

Ein fehlgeschlagener Submodul-Fetch endet ebenfalls mit Exit-Code 128. Die Submodul-URL ist möglicherweise privat (benötigt ein Token), zeigt auf einen Commit, der upstream nicht mehr existiert, oder verwendet SSH. Führen Sie git submodule status lokal aus und prüfen Sie, ob jeder angeheftete Commit auf seinem Remote existiert.

So verhindern Sie den Fehler

  1. Fixieren Sie actions/checkout auf eine aktuelle Hauptversion und lesen Sie die fatal:-Zeile, nicht nur den Exit-Code.
  2. Legen Sie fetch-depth bewusst für Schritte fest, die die Historie lesen.
  3. Verwenden Sie für jedes andere Repository als das aktuelle ein eingeschränktes Token.
  4. Entfernen Sie Workflow-Verweise auf Branches, die gelöscht werden, und verwenden Sie SHAs für Builds von Pull Requests.
  5. Halten Sie Submodul-Zeiger auf Commits, die gepusht sind.

FAQ

Was bedeutet Exit-Code 128 in git?

Ein schwerwiegender Fehler. Git gibt eine fatal:-Meldung aus, die ihn erklärt, und beendet sich mit 128.

Warum steht dort /usr/bin/git?

actions/checkout und andere Actions führen git als Kindprozess aus, und der Runner meldet, welcher Prozess mit welchem Code fehlgeschlagen ist.

Ist es ein GitHub-Ausfall?

Wenn viele unabhängige Workflows gleichzeitig beim Abrufen fehlschlagen, prüfen Sie die GitHub-Statusseite. Andernfalls verweist die fatal:-Zeile auf Ihre Konfiguration.

Soll ich einfach erneut ausführen?

Nur wenn die Meldung wie ein Netzwerk- oder Serverfehler aussieht (etwa RPC failed oder early EOF). Fehler bei der Authentifizierung oder bei fehlenden Referenzen schlagen erneut fehl.