Zum Inhalt springen

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

  1. Öffnen Sie die Laufzusammenfassung und lesen Sie die Annotationen. Dort steht oft, wer oder was den Abbruch ausgelöst hat.
  2. Prüfen Sie den Workflow auf concurrency:. Wenn vorhanden und cancel-in-progress: true gesetzt ist, liegt die Ursache wahrscheinlich dort.
  3. Prüfen Sie auf eine Matrix. Wenn eine Zelle fehlgeschlagen ist, beheben Sie diese.
  4. Vergleichen Sie die Laufzeit des Jobs mit timeout-minutes.
  5. Tritt es nur auf selbst gehosteten Runnern auf, prüfen Sie die Host-Protokolle auf Neustarts.

So verhindern Sie den Fehler

  1. Verwenden Sie concurrency-Gruppen pro Ref, nie eine globale Gruppe für alle Branches.
  2. Deaktivieren Sie cancel-in-progress für Deployment- und Release-Workflows.
  3. Setzen Sie fail-fast: false bei Matrizen, deren Zellen unabhängig voneinander sind.
  4. Fügen Sie timeout-minutes zu jedem Job und jedem langsamen Schritt hinzu.
  5. 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.