Cache Service Responded With 429: So beheben Sie den Fehler
Zuletzt aktualisiert am
Failed to restore: Cache service responded with 429 bedeutet, dass der Cache-Dienst von GitHub Actions Ihre Anfrage abgelehnt hat, weil ein Ratenlimit erreicht wurde: HTTP 429 steht für "too many requests" (zu viele Anfragen). Das tritt meist auf, wenn viele Jobs gleichzeitig Caches wiederherstellen oder speichern, zum Beispiel wenn eine große Matrix gleichzeitig startet. Für sich genommen ist es eine Warnung: Der Cache-Schritt meldet, dass das Wiederherstellen oder Speichern fehlgeschlagen ist, der Job läuft jedoch weiter, nur langsamer.
Die genaue Meldung
Warning: Failed to restore: Cache service responded with 429
Warning: Failed to save: Cache service responded with 429
GitHub veröffentlicht auf der Seite zu den Nutzungslimits keine feste Anfragerate für den Cache-Dienst. Es gibt also keinen Wert, unter dem Sie bleiben könnten. Der praktische Ansatz ist, weniger Anfragen zu stellen und diese zeitlich besser zu verteilen.
Lösung 1: Aktuelle Version von actions/cache verwenden
Alte Versionen der Cache-Action kommunizieren mit einem veralteten Dienst, den GitHub eingestellt hat, und schlagen deshalb auf unterschiedliche Weise fehl. Verwenden Sie die aktuelle Hauptversion:
- uses: actions/cache@v4
with:
path: ~/.npm
key: npm-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
restore-keys: npm-${{ runner.os }}-
Dasselbe gilt für die integrierten Caches von actions/setup-node, setup-python und setup-java: Verwenden Sie auch dort die aktuellen Versionen.
Lösung 2: Nur ein Job speichert, die anderen stellen nur wieder her
Wenn 30 Matrix-Jobs jeweils denselben Cache speichern, senden Sie 30 Speicheranfragen für einen einzigen Cache-Eintrag, und 29 davon sind überflüssig. Stellen Sie überall wieder her und speichern Sie nur in einem Job:
- uses: actions/cache/restore@v4
id: cache
with:
path: ~/.npm
key: npm-${{ hashFiles('**/package-lock.json') }}
# ... install and test ...
- uses: actions/cache/save@v4
if: matrix.shard == 1 && steps.cache.outputs.cache-hit != 'true'
with:
path: ~/.npm
key: npm-${{ hashFiles('**/package-lock.json') }}
Die Angabe id: cache beim Wiederherstellungsschritt ermöglicht es der save-Bedingung, die Ausgabe cache-hit auszuwerten.
Lösung 3: Den Start einer großen Matrix verlangsamen
strategy.max-parallel begrenzt, wie viele Matrix-Jobs gleichzeitig laufen. Dadurch verteilen sich auch die Cache-Anfragen.
strategy:
max-parallel: 10
matrix:
shard: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20]
Lösung 4: Weniger, dafür größere Cache-Einträge
Mehrere kleine Caches in einem Job bedeuten mehrere Anfragen. Fassen Sie Cache-Pfade mit demselben Schlüssel zusammen und verzichten Sie darauf, Dinge zu cachen, die schnell heruntergeladen sind. Siehe Caching in GitHub Actions und Cache-Limits.
Lösung 5: Erneut ausführen
Ratenlimits werden wieder aufgehoben. War es ein einmaliger Ausreißer, führen Sie die fehlgeschlagenen Jobs erneut aus. Tritt der Fehler bei jedem Lauf auf, wenden Sie die oben genannten Lösungen an.
Wenn der Job wegen des fehlenden Caches fehlschlägt
Ein 429 beim Wiederherstellen führt zu einem Cache-Miss. Wenn ein späterer Schritt vom Cache abhängt und fehlschlägt, lesen Sie Cache not found for input keys. Setzen Sie fail-on-cache-miss: true nur, wenn ein Cache-Miss den Build fehlschlagen lassen soll.
So verhindern Sie den Fehler
- Fixieren Sie
actions/cache@v4oder eine neuere Version und aktualisieren Sie sie mit Dependabot. - Speichern Sie aus einem Job heraus und stellen Sie überall wieder her.
- Begrenzen Sie die Parallelität von Matrizen bei großen Verteilungen.
- Setzen Sie auf wenige, gut gewählte Caches statt auf viele winzige.
FAQ
Lässt ein 429 meinen Workflow fehlschlagen?
Standardmäßig nicht. Der Cache-Schritt protokolliert eine Warnung und der Job läuft weiter, ohne Cache kann er aber deutlich länger dauern.
Ist das dasselbe wie das Ratenlimit der GitHub-API?
Nein. Hier geht es um den Cache-Dienst. Zum Ratenlimit der REST-API siehe API rate limit exceeded.
Vermeidet ein selbst gehosteter Runner das Problem?
Nicht von selbst, denn auch selbst gehostete Runner nutzen denselben Cache-Dienst von GitHub. Ein lokaler Cache auf dem Speicher des Runners umgeht den Dienst, erfordert dafür aber eine eigene Verwaltung.
Warum tritt der Fehler auf, obwohl sich nichts geändert hat?
Ratenlimits hängen von der Auslastung ab. Eine größere Matrix, mehr gleichzeitige Läufe oder eine Phase hoher Last auf Seiten von GitHub können alle dazu führen.
Verwandt
- Cargo- und Rust-Builds in GitHub Actions cachenCargo-Registry, Git-Abhängigkeiten und Target-Verzeichnis in GitHub Actions mit Swatinem/rust-cache oder actions/cache cachen, ohne aufgeblähte Caches.
- Go-Module und Build-Cache in GitHub Actions cachenGo-Module (GOMODCACHE) und Build-Cache (GOCACHE) in GitHub Actions mit setup-go oder actions/cache cachen. Keys, go.sum und Cache-Treffer prüfen.
- Gradle-Builds in GitHub Actions cachenGradle-Abhängigkeiten und Build-Cache in GitHub Actions mit gradle/actions/setup-gradle oder actions/cache cachen. Keys, PRs, Bereinigung, Checks.
- npm-Abhängigkeiten in GitHub Actions cachennpm-Abhängigkeiten in GitHub Actions cachen, mit setup-node oder actions/cache. Funktionierendes YAML, der richtige Key, warum nicht node_modules, und Treffer prüfen.