Der Vorgang wurde abgebrochen in GitHub Actions
Zuletzt aktualisiert am
The operation was canceled bedeutet, dass GitHub Ihren Job oder Schritt beendet hat, bevor er fertig war, und zwar absichtlich: Ein neuerer Lauf hat ihn ersetzt, ein paralleler Job ist fehlgeschlagen, ein Timeout wurde erreicht oder jemand hat den Abbruch ausgelöst. Meist liegt der Fehler nicht in Ihrem Code. Diese Seite listet die Ursachen nach Wahrscheinlichkeit auf und zeigt, wie Sie sie auf der Lauf-Seite unterscheiden. Das Verhalten stammt aus der Referenz zur Workflow-Syntax von GitHub, Stand Oktober 2026.
Die genaue Meldung
Error: The operation was canceled.
Varianten, die Ihnen daneben begegnen können:
Canceling since a higher priority waiting request for 'ci-refs/heads/main' exists
Error: The run was canceled by @username.
The runner has received a shutdown signal.
Sehen Sie sich die Annotationen oben in der Laufzusammenfassung an. Dort wird die Ursache meist genannt.
Ursache 1: concurrency mit cancel-in-progress
Wenn ein Workflow concurrency mit cancel-in-progress: true deklariert, bricht ein erneutes Pushen den früheren Lauf derselben Gruppe ab. Der abgebrochene Job protokolliert The operation was canceled.
concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
Das ist für Pull-Request-CI gewünscht. Für Deployments oder Release-Jobs ist es nicht gewünscht, denn ein Abbruch mitten im Ablauf kann Vorgänge halb ausgeführt zurücklassen. Beachten Sie außerdem die Regel von GitHub: Standardmäßig wird ein bestehender wartender Run in derselben Gruppe durch den neu eingereihten ersetzt, auch ohne cancel-in-progress. Genau das bedeutet die Meldung „higher priority waiting request“.
Lösung für Deployments:
concurrency:
group: deploy-production
cancel-in-progress: false
Mit false läuft ein Lauf und einer wartet; ältere wartende Läufe werden weiterhin verworfen. Wenn jeder Lauf ausgeführt werden muss, verwenden Sie pro Lauf eindeutige Gruppennamen oder eine Merge Queue (siehe GitHub Merge Queue). Nur in CI-Jobs abbrechen:
concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
Ursache 2: fail-fast bei Matrizen
In einer Matrix ist fail-fast standardmäßig auf true gesetzt. Schlägt eine Zelle fehl, bricht GitHub die noch laufenden Zellen ab, und diese melden "The operation was canceled", obwohl sie in Ordnung waren. Der eigentliche Fehler steckt in der einen roten Zelle, nicht in den abgebrochenen.
strategy:
fail-fast: false
matrix:
node: [18, 20, 22]
Setzen Sie fail-fast: false beim Debuggen, damit Sie das echte Ergebnis jeder Zelle sehen. Siehe Matrix-Builds.
Ursache 3: Timeouts
Ein Schritt oder Job, der timeout-minutes überschreitet, wird abgebrochen. Das Maximum für Schritte beträgt 360 Minuten, GitHub-gehostete Jobs sind auf 6 Stunden begrenzt. Häufig hängt ein Schritt und wartet auf eine Eingabe oder einen Netzwerkdienst. Lesen Sie das Verhalten von timeout-minutes und die Zeitlimits. Setzen Sie explizite Grenzen, damit Hänger schnell fehlschlagen:
jobs:
test:
timeout-minutes: 20
steps:
- run: npm test
timeout-minutes: 15
Ursache 4: Eine Person oder die API hat den Lauf abgebrochen
Jemand hat auf Workflow abbrechen geklickt oder eine Automatisierung hat die API aufgerufen. So finden Sie es heraus:
gh run view RUN_ID --log | head -50
gh api repos/OWNER/REPO/actions/runs/RUN_ID --jq '.conclusion, .actor.login'
Häufige Auslöser sind Release-Werkzeuge und gh run cancel in anderen Workflows.
Ursache 5: Runner-Abschaltung oder Verbindungsverlust
Selbst gehostete Runner auf Spot-Instanzen oder Runner-Hosts, die neu starten, geben The runner has received a shutdown signal aus und brechen danach die Schritte ab. Gehostete Runner können nach einer Infrastrukturstörung ebenfalls entzogen werden. Verwenden Sie ephemere Runner mit geordnetem Herunterfahren oder wechseln Sie zu gehosteten Runnern. Wenn das Protokoll stattdessen einen Kommunikationsverlust meldet, lesen Sie gehosteter Runner hat die Kommunikation verloren.
Ursache 6: Ein abhängiger Job ist fehlgeschlagen
Ein Job mit needs: wird übersprungen, nicht abgebrochen, wenn seine Abhängigkeit fehlschlägt. Sehen Sie einen Abbruch, prüfen Sie zuerst fail-fast oder concurrency. Ein Aufräumschritt mit if: always() läuft bei einem Abbruch nur dann, wenn Sie if: always() oder if: cancelled() verwendet haben:
- name: Clean up
if: always()
run: ./cleanup.sh
Schrittweise Diagnose
- Öffnen Sie die Laufzusammenfassung und lesen Sie die Annotationen. Dort steht oft, wer oder was den Abbruch ausgelöst hat.
- Prüfen Sie den Workflow auf
concurrency:. Wenn vorhanden undcancel-in-progress: truegesetzt ist, liegt die Ursache wahrscheinlich dort. - Prüfen Sie auf eine Matrix. Wenn eine Zelle fehlgeschlagen ist, beheben Sie diese.
- Vergleichen Sie die Laufzeit des Jobs mit
timeout-minutes. - Tritt es nur auf selbst gehosteten Runnern auf, prüfen Sie die Host-Protokolle auf Neustarts.
So verhindern Sie den Fehler
- Verwenden Sie concurrency-Gruppen pro Ref, nie eine globale Gruppe für alle Branches.
- Deaktivieren Sie
cancel-in-progressfür Deployment- und Release-Workflows. - Setzen Sie
fail-fast: falsebei Matrizen, deren Zellen unabhängig voneinander sind. - Fügen Sie
timeout-minuteszu jedem Job und jedem langsamen Schritt hinzu. - Verwenden Sie
if: always()für Aufräumarbeiten, die unbedingt laufen müssen.
Abgebrochene Runs verbrauchen Minuten bis zu dem Moment, in dem sie stoppen. Deshalb spart der concurrency-Ansatz Geld; siehe Reduzieren Sie Ihre GitHub Actions-Kosten. Er hilft auch bei Warteschlangen, siehe Warten auf einen Runner. Wenn Sie kürzere Jobs möchten, die seltener abgebrochen werden, laufen bestehende Jobs bei compiler.dev nach einer einzeiligen Änderung von runs-on auf Maschinen mit 8 vCPU / 16 GB.
FAQ
Bricht cancel-in-progress nur ältere Läufe ab?
Ja. Der neueste Lauf in einer concurrency-Gruppe läuft weiter, und laufende Läufe derselben Gruppe werden abgebrochen, wenn cancel-in-progress: true gesetzt ist.
Warum stehen bei meinen erfolgreichen Matrixzellen "canceled"?
fail-fast ist standardmäßig auf true gesetzt. Eine fehlgeschlagene Zelle bricht die anderen noch laufenden Zellen ab.
Kann ich feststellen, wer einen Lauf abgebrochen hat?
Ja, in der Zusammenfassung des Laufs als Annotation und über das API-Feld actor sowie im Audit-Trail des Repositorys.
Wird ein abgebrochener Lauf berechnet?
Sie zahlen für die Minuten, die vor dem Abbruch verbraucht wurden.
Verwandt
- Cache Service Responded With 429: So beheben Sie den FehlerFix "Failed to restore: Cache service responded with 429" in GitHub Actions: zu viele Cache-Anfragen. actions/cache aktualisieren, einmal wiederherstellen, einmal speichern.
- fatal: could not read Username for github.com: BehebenBehebe "fatal: could not read Username for 'https://github.com'" in GitHub Actions: Private Repos, Submodules und Git-Abhängigkeiten benötigen einen Token.
- Ungültige Workflow-Datei: YAML-Syntaxfehler beheben"Ungültige Workflow-Datei" und "Fehler in der YAML-Syntax" in GitHub Actions beheben: Einrückung, unerwarteter Wert, fehlerhafte Ausdrücke, mit actionlint.
- JavaScript Heap Out of Memory in GitHub Actions: BehebenBeheben Sie "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" und npm ENOMEM in GitHub Actions mit NODE_OPTIONS.