コンテンツにスキップ
Zenn Dev Snowcait Articles 8ff19df6d387dd

GitHub Actions で Error: Can’t use ’tar -xzf’ extract archive file

  • URL: https://zenn.dev/snowcait/articles/8ff19df6d387dd
  • 日付: 2026-06-26
  • Tier: Tier 3
  • 要旨: 2023 年 9 月 4 日以降、GitHub Actions で actions/checkout@v3 を使うと tar -xzf でのアーカイブ展開に失敗するエラーが報告されている。同日に actions/checkout@v4.0.0 がリリースされており、ダウンロード集中による一時的な負荷が原因と推測されている。対処法は再実行を待つか、v4 に更新することで、v4 への移行後にエラーが解消したという報告が多い。v4 では Node.js ランタイムが v20 になっているため、移行前に動作確認が推奨されている。

詳細

発生エラー: Error: Can’t use ’tar -xzf’ extract archive file: /home/runner/work/_actions/temp*.tar.gz. return code: 2.

発生条件: actions/checkout@v3 使用時、2023/09/04 以降

対処法1: しばらく待って再実行する(一時的な負荷の場合は自然解消) 対処法2: actions/checkout@v4 に更新する

  • uses: actions/checkout@v4

注意点: v4 は Node.js v20 ランタイムに変更されているため、依存するスクリプトや他のアクションとの互換性を事前に確認する。