Zum Inhalt springen

Cache nicht gefunden für Input-Keys: Ursachen und Lösungen

Zuletzt aktualisiert am

Cache not found for input keys ist ein Cache-Miss von actions/cache: Kein gespeicherter Cache passte zu Ihrem key oder Ihren restore-keys, daher wird der Schritt ohne Wiederherstellung fortgesetzt. In den meisten Workflows ist das eine Warnung, und der Job läuft weiter. Wenn der nächste Schritt den Cache benötigt, kann es jedoch wie ein Fehler wirken. Diese Seite erklärt, warum der Cache nicht gefunden wurde und wie Sie einen Treffer erzielen. Die Regeln stammen aus der Referenz zum Caching von Abhängigkeiten von GitHub, Stand Oktober 2026.

Die genaue Meldung

Cache not found for input keys: Linux-npm-3f1c0d9a2b..., Linux-npm-

Bei actions/cache/restore mit fail-on-cache-miss: true erhalten Sie stattdessen einen fehlgeschlagenen Schritt. Der erste aufgeführte Schlüssel ist Ihr key, die übrigen sind Ihre restore-keys. Ein Miss beim ersten Lauf für einen neuen Schlüssel ist normal: Der Post-Schritt speichert den Cache, und spätere Läufe treffen ihn.

So funktioniert die Suche

  1. Die Aktion sucht im aktuellen Branch nach einer exakten Übereinstimmung mit key.
  2. Falls keine gefunden wird, sucht sie nach Präfix-Übereinstimmungen mit key und dann mit jedem Eintrag in restore-keys, in dieser Reihenfolge. Bei mehreren Teiltreffern wird der zuletzt erstellte Cache zurückgegeben.
  3. Falls auch dann nichts gefunden wird, wiederholt sich die Suche im Standard-Branch.

Regeln zum Geltungsbereich: Ein Lauf kann Caches aus dem aktuellen Branch oder dem Standard-Branch wiederherstellen, Pull Requests zusätzlich aus dem Basis-Branch. Caches von Geschwister- oder Unter-Branches können nicht wiederhergestellt werden. Tag-Caches sind pro Tag isoliert. Einträge, die 7 Tage lang nicht verwendet wurden, werden entfernt, und das Standardlimit liegt bei 10 GB pro Repository.

Ursachen, nach Wahrscheinlichkeit sortiert

1. Es ist der erste Lauf für diesen Schlüssel

Jeder neue Schlüssel trifft einmal nicht. Wenn Ihr Schlüssel hashFiles('**/package-lock.json') enthält, führt jede Änderung der Lockdatei einmalig zu einem Miss. Hier gibt es nichts zu beheben. Fügen Sie restore-keys hinzu, damit eine ähnliche Übereinstimmung etwas wiederherstellt:

- uses: actions/cache@v4
  with:
    path: ~/.npm
    key: npm-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      npm-${{ runner.os }}-

2. Der Schlüssel ändert sich bei jedem Lauf

Schlüssel wie ${{ github.sha }}, ${{ github.run_id }} oder ein Zeitstempel passen nie zu einem früheren Lauf. Verwenden Sie als Schlüssel die Datei, die den Inhalt bestimmt (die Lockdatei), nicht den Commit. Der Cache-Schlüssel-Generator erzeugt sichere Schlüssel.

3. Der Cache liegt auf einem Branch, auf den Sie keinen Zugriff haben

Ein Feature-Branch speichert seinen Cache unter diesem Branch. Ein anderer Feature-Branch kann ihn nicht sehen. Läufe von Pull Requests speichern Caches für die Merge-Referenz, sodass ein PR einen anderen nicht vorwärmt. Lösung: Stellen Sie sicher, dass der Standard-Branch den Cache speichert, etwa mit einem Workflow bei Push auf main oder einem zeitgesteuerten Lauf, damit jeder Branch darauf zurückgreifen kann.

on:
  push:
    branches: [main]
  schedule:
    - cron: "0 3 * * *"

4. Der Cache wurde entfernt

Nach 7 Tagen ohne Zugriff oder wenn das Repository 10 GB überschreitet, werden Einträge gelöscht, zuerst die am längsten ungenutzten. Prüfen Sie Actions, dann Caches im Repository, oder führen Sie gh cache list aus. Details und Lösungen unter GitHub Actions cache limits.

5. path oder runner.os unterscheiden sich

Der Cache ist an seinen Schlüssel und zusätzlich an seine Version gebunden, die sich aus den Pfaden und der Komprimierungsmethode ableitet. Ändern Sie path oder stellen Sie auf einem anderen Betriebssystem wieder her, als es gespeichert wurde, kommt es zu einem Miss. Nehmen Sie runner.os in den Schlüssel auf und halten Sie den Pfad beim Speichern und Wiederherstellen identisch.

6. Das Speichern hat nie stattgefunden

Der Post-Schritt speichert nur, wenn der Job erfolgreich war und der Schlüssel keinen exakten Treffer hatte. Ist der Job vor dem Ende fehlgeschlagen, wurde nichts gespeichert. Verwenden Sie actions/cache/save mit if: always(), wenn Sie auch nach einem Fehler speichern möchten:

- uses: actions/cache/restore@v4
  id: cache
  with: { path: ~/.cache/pip, key: pip-${{ hashFiles('requirements.txt') }} }
- run: pip install -r requirements.txt
- uses: actions/cache/save@v4
  if: always() && steps.cache.outputs.cache-hit != 'true'
  with: { path: ~/.cache/pip, key: pip-${{ hashFiles('requirements.txt') }} }

7. Zwei Jobs wollen denselben Schlüssel gleichzeitig speichern

Cache-Einträge sind unveränderlich. Speichern zwei Matrix-Zellen denselben Schlüssel, setzt sich einer durch, und die andere protokolliert einen Reservierungsfehler. Geben Sie jeder Zelle einen eigenen Schlüssel oder speichern Sie aus nur einem Job.

Den Output cache-hit nutzen

cache-hit ist nur bei einer exakten Schlüsselübereinstimmung true, nicht bei einer Übereinstimmung über restore-keys. Damit können Sie Arbeit überspringen:

- uses: actions/cache@v4
  id: cache
  with:
    path: node_modules
    key: nm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
- if: steps.cache.outputs.cache-hit != 'true'
  run: npm ci

Beachten Sie, dass ein Treffer über restore-keys cache-hit auf false setzt, obwohl Dateien wiederhergestellt werden.

Wenn Caching nicht hilft

Wenn Caches immer wieder verfehlt werden, sehr groß sind oder das Wiederherstellen langsamer ist als die Installation, die es ersetzt, ist ein Runner mit vorgewärmten lokalen Caches möglicherweise die bessere Lösung. Die Maschinen von compiler.dev halten Caches für Abhängigkeiten, Git und Docker-Layer bereit, sodass Sie dafür keine Schlüssel verwalten müssen; siehe Preise. Weitere Optionen: Caching in GitHub Actions und Docker-Layer-Caching. Große Caches verursachen außerdem No space left on device.

So verhindern Sie den Fehler

  1. Verwenden Sie Lockdateien als Schlüssel, fügen Sie einen Fallback mit restore-keys hinzu und nehmen Sie runner.os auf.
  2. Speichern Sie Caches aus dem Standard-Branch, damit jeder PR sie wiederherstellen kann.
  3. Halten Sie die Gesamtgröße der Caches deutlich unter 10 GB.
  4. Prüfen Sie die Trefferquote wöchentlich in Ihren Protokollen und nutzen Sie den Rechner für die Einsparungen durch Cache-Treffer, um zu sehen, was ein Miss kostet.

FAQ

Ist „Cache not found for input keys“ ein Fehler?

Nein, es ist eine Informationsmeldung über einen Miss. Der Job läuft weiter, sofern Sie nicht fail-on-cache-miss: true setzen.

Warum habe ich bei jedem Pull Request einen Cache-Miss?

PR-Caches sind auf die Merge-Referenz beschränkt, und ein PR kann nur aus sich selbst, seinem Basis-Branch und dem Standard-Branch wiederherstellen. Stellen Sie sicher, dass der Standard-Branch den Cache speichert.

Wie lange bleibt ein Cache in GitHub Actions erhalten?

Sieben Tage seit dem letzten Zugriff, sofern er nicht vorher wegen Überschreitung des Repository-Limits entfernt wird.

Warum wird mein Cache wiederhergestellt, aber cache-hit ist false?

Eine Übereinstimmung über restore-key (Präfix) stellt Dateien wieder her, zählt aber nicht als exakter Treffer, daher ist cache-hit false.