Lesstep
GitHub Actions・2026年11月3日に確認

GitHub Actions：「Cache not found for input keys」

復元のステップがキャッシュのエントリを探し、見つからなかったので、ジョブはそれ無しで動きます。エラーではなく、ステップは成功します。大事なのはなぜ何も合わなかったかで、たいてい次の5つのどれかです。

見え方

2026年10月、このせいで13分かかったプルリクエストのビルドから（homeboy #17018）：

Cache not found for input keys: Linux-cargo-source-v2-8c1ea9e4…-7eb031de…-8f01ff49…, Linux-cargo-source-v2-8c1ea9e4…-7eb031de…-

1. キーが変わった

中身を決めるファイルだけをハッシュし、ビルドの出力は外し、復元のステップが使ったキーで保存し、ぴったりのエントリが無いときに近いものを使えるよう restore key を足します：

- uses: actions/cache/restore@v6
  id: restore-cache
  with:
    path: ~/.m2/repository
    key: maven-repo-${{ hashFiles('**/pom.xml', '!**/target/**') }}
    restore-keys: maven-repo-

# ... build ...

- uses: actions/cache/save@v6
  if: steps.restore-cache.outputs.cache-hit != 'true'
  with:
    path: ~/.m2/repository
    key: ${{ steps.restore-cache.outputs.cache-primary-key }}

2. この実行から読めないスコープにある

デフォルトブランチへの push の実行に、プルリクエストが復元するエントリを、同じキーの作り方で保存させます。

3. キーは同じで、バージョンが違う

エントリにはキーのほかにバージョンがあり、復元は restore key のときも含め、同じバージョンのものにしか合いません。toolkit はバージョンを次から計算します：

ステップのデバッグのログを有効にすると、復元は「Cache not found for version <hash> of keys: ...」も出すので、いまあるエントリのバージョンと比べられます（デバッグのログの有効にし方）。

4. 追い出された

エントリを減らして小さくする、プルリクエストでは保存しない（保存のステップに if: github.event_name == 'push'）、またはリポジトリの Actions の設定で上限を上げます（10 GB を超えた分は課金）。

5. ダウンロードに失敗した

エントリは見つけたのにダウンロードできなかった復元も、同じ行で終わります（helion #3799）：

Cache hit for: triton-thirdparty-b200-tileir-0d9283bf49
Received 125829120 of 1547099396 (8.1%), 30.0 MBs/sec
...
Failed to restore: The operation cannot be completed in timeout.
Cache not found for input keys: triton-thirdparty-b200-tileir-0d9283bf49

1行上を見ます。「Cache hit for」のあとに「Failed to restore」があれば、エントリが無いのではなく、ダウンロードの問題です。

何があるかを見る

gh cache list --key maven-repo- --json key,ref,version,lastAccessedAt,sizeInBytes

外れたときの cache-hit は空

見分け方

失敗したジョブを IntelliJ IDEA から見るなら

Pipeline Inbox for GitHub Actions Workflows は、Lesstep が作っている JetBrains IDE（2024.1 以降）のプラグインです。すべてのリポジトリの実行を、ジョブ・ステップと一緒に IDE のツールウィンドウに並べ、いまのブランチの実行はステータスバーに出ます。読むのは無料、失敗したジョブの再実行・キャンセル・ワークフローの実行・デプロイのレビューは Pro（月 US$1.50・30日の無料試用つき）です。

GitHub と GitHub Actions は GitHub, Inc. の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは GitHub, Inc.・JetBrains のいずれとも提携しておらず、承認も受けていません。

ほかに：「Unable to reserve cache」 · デバッグのログと ACTIONS_STEP_DEBUG · 「No space left on device」 · IntelliJ IDEA で使える GitHub Actions のプラグインの比較 · English