Zum Inhalt springen

360 Minuten maximale Ausführungszeit überschritten: Behebung

Zuletzt aktualisiert · Erstmals veröffentlicht

The job running on runner ... has exceeded the maximum execution time of 360 minutes bedeutet, dass Ihr Job 6 Stunden lang lief, das Limit für GitHub-gehostete Runner, und GitHub ihn beendet hat. Fast immer war der Job hängen geblieben und nicht einfach langsam: ein hängender Test, ein Prozess, der auf Eingaben wartet, oder ein Deadlock. Diese Seite erklärt, wie timeout-minutes für Jobs und Steps funktioniert, wie Sie herausfinden, was hängen geblieben ist, und wie Sie frühzeitig abbrechen, statt 6 Stunden Minuten zu verbrauchen. Die Limits stammen aus der GitHub-Seite zu den Nutzungslimits und der Workflow-Syntax, geprüft im Oktober 2026.

Die genaue Meldung

The job running on runner GitHub Actions 5 has exceeded the maximum execution time of 360 minutes.

Name und Nummer des Runners variieren. Wenn Sie ein niedrigeres timeout-minutes setzen, entspricht die Zahl in der Meldung Ihrem Wert statt 360. Ein per Timeout beendeter Step wird als abgebrochen angezeigt, manchmal mit The operation was canceled (siehe diese Seite).

Die Limits

  • GitHub-gehostete Jobs: begrenzt auf 6 Stunden. Ein Job, der das Limit erreicht, wird beendet und schlägt fehl.
  • Selbst gehostete Jobs: begrenzt auf 5 Tage.
  • Step timeout-minutes: maximal 360 für gehostete und selbst gehostete Runner.
  • Workflow-Lauf: 35 Tage einschließlich Warte- und Genehmigungszeit. Läufe, die dieses Limit erreichen, werden abgebrochen.
  • Warteschlangenzeit für Jobs auf selbst gehosteten Runnern: 24 Stunden, danach Abbruch.

Wenn Sie timeout-minutes für einen Job nicht setzen, kann der Job bis zu 360 Minuten laufen, was auf gehosteten Runnern der Standard ist. Ein hängen gebliebener 6-Stunden-Job auf einem großen Runner ist teuer: Sechs Stunden zum Satz eines 8-Kern-Runners kosten real Geld. Siehe Zeitlimits und Preise.

So funktioniert timeout-minutes

Auf Job-Ebene

jobs:
  test:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

Überschreitet der Job 20 Minuten, bricht GitHub ihn ab, führt Steps mit if: always() oder if: cancelled() nach bestem Bemühen aus und markiert den Job als fehlgeschlagen.

Auf Step-Ebene

steps:
  - run: ./integration-tests.sh
    timeout-minutes: 10

Der Step wird nach 10 Minuten beendet. Der Job schlägt dann fehl, es sei denn, der Step hat continue-on-error: true. Step-Timeouts verlängern das Job-Timeout nicht: Das Job-Limit gilt weiterhin für die Gesamtzeit.

Matrix-Jobs

timeout-minutes gilt für jeden Matrix-Job einzeln. Ein Zeitüberschreitung in einer Zelle kann in den anderen fail-fast-Abbrüche auslösen (Details unter The operation was canceled).

Warum ist der Job 6 Stunden lang hängen geblieben?

1. Ein Test, der nie endet

Offene Handles, ein nicht aufgelöstes Promise, ein Deadlock oder ein Netzwerkaufruf ohne Timeout. Fügen Sie ein Timeout pro Test in Ihrem Runner hinzu (Jest --testTimeout, pytest-timeout, go test -timeout 10m).

- run: go test -timeout 10m ./...
- run: pytest --timeout=300

2. Ein Befehl, der auf Eingaben wartet

Installer, apt, ssh und npm init können nachfragen. Verwenden Sie nicht-interaktive Flags:

- run: sudo apt-get install -y --no-install-recommends build-essential
  env:
    DEBIAN_FRONTEND: noninteractive

3. Ein Hintergrundprozess, der den Step offen hält

Ein mit & gestarteter Dev-Server, der nie beendet wird, kann den Step offen halten, wenn seine Ausgabe angebunden ist. Leiten Sie die Ausgabe um und beenden Sie den Prozess:

- run: |
    npm run start > server.log 2>&1 &
    npx wait-on http://localhost:3000 --timeout 60000
    npx playwright test

4. Warten auf einen externen Dienst oder eine Genehmigung

Ein Step, der den Deploy-Status endlos abfragt, oder ein Job, der auf eine Umgebungsgenehmigung wartet. Geben Sie Abfrageschleifen eine Frist.

5. Ein Runner ohne Arbeitsspeicher

Thrashing lässt alles kriechen. Prüfen Sie auf Anzeichen für Exit-Code 137 und verlorene Kommunikation.

6. Die Arbeit ist tatsächlich so lang

Wenn ein legitimer Job mehr als 6 Stunden braucht, teilen Sie ihn in Jobs auf (eine Matrix oder Sharding; siehe Test-Sharding) oder verwenden Sie einen selbst gehosteten Runner, dessen Limit 5 Tage beträgt. Schnellere Maschinen helfen ebenfalls: compiler.dev führt Ihre bestehenden Jobs auf 8 vCPU / 16 GB großen Maschinen aus, nachdem Sie eine Zeile zu runs-on: [self-hosted, Linux, compiler-ci] geändert haben; siehe Benchmarks und Preise.

Finden Sie heraus, was hängen geblieben ist

  1. Öffnen Sie das Protokoll des abgebrochenen Jobs. Die letzten Zeilen vor dem Abbruch zeigen Ihnen den Step.
  2. Führen Sie den Lauf mit Debug-Logging erneut aus, indem Sie die Variable ACTIONS_STEP_DEBUG auf true setzen.
  3. Reproduzieren Sie das Problem mit einem kurzen Timeout, damit Sie nicht sechs Stunden warten: Setzen Sie vorübergehend timeout-minutes: 10.
  4. Fügen Sie timeout zu Befehlen hinzu, die Sie verdächtigen:
timeout 300 ./slow-command.sh || echo "timed out after 300s"

So setzen Sie sinnvolle Werte

Als Faustregel gilt etwa das 2- bis 3-Fache Ihrer normalen Dauer. Brauchen Tests 8 Minuten, verwenden Sie 20 oder 25. Sehen Sie sich aktuelle Läufe an, um die p95-Zeit zu ermitteln. Der Leitfaden zu langsamer CI behandelt die Verkürzung der normalen Dauer, und der Rechner für die Kosten langsamer CI zeigt, was hängende Jobs kosten.

So verhindern Sie den Fehler

  1. Setzen Sie timeout-minutes für jeden Job. Belassen Sie nicht den Standardwert von 360.
  2. Setzen Sie engere Limits für Schritte, von denen bekannt ist, dass sie hängen bleiben (E2E-Tests, Deployment-Polling).
  3. Ergänzen Sie zusätzlich Timeouts des Test-Runners, damit Sie einen brauchbaren Stack-Trace erhalten.
  4. Fügen Sie für PRs concurrency mit cancel-in-progress hinzu, damit verwaiste Runs früh beendet werden; siehe Ihre Actions-Kosten senken.
  5. Lösen Sie einen Alarm aus, sobald ein Job länger als das Doppelte seines Medianwerts läuft.

FAQ

Was ist das Standard-Timeout für einen GitHub Actions Job?

360 Minuten (6 Stunden) auf GitHub-gehosteten Runnern. Mit timeout-minutes setzen Sie es für diesen Job niedriger.

Kann ich das Limit über 360 Minuten anheben?

Auf GitHub-gehosteten Runnern nicht. Selbst gehostete Jobs können bis zu 5 Tage laufen.

Führt ein Step-Timeout zum Fehlschlagen des Jobs?

Ja, sofern der Step nicht continue-on-error: true gesetzt hat.

Kosten Minuten, die durch ein Timeout abgebrochen wurden, Geld?

Ja. Die Laufzeit gehosteter Runner wird für die Zeit berechnet, die der Job vor dem Abbruch lief. Ein hängender Job verursacht daher die volle Dauer an Kosten.