🚨 GitHub Actions actions/cache@v2 오류 발생 원인 및 해결 방법

🚨 GitHub Actions actions/cache@v2 오류 발생 원인 및 해결 방법

---

❌ 상황: actions/cache@v2 설정 시 오류

GitHub Actions에서 다음과 같은 오류가 발생했습니다:

Error: Missing download info for actions/cache@v2

📌 여러 방법으로 시도해도 v2 버전을 정상적으로 받아오지 못하는 문제가 계속 발생했습니다.

---

⚠️ 주요 원인 정리

원인 설명

❌ v2 메타데이터 누락	GitHub Marketplace의 캐시 메타데이터가 손상되었거나 유실된 경우 발생
❌ Runner 버전과의 불일치	사용 중인 runner 이미지가 v2 버전을 지원하지 않는 경우 발생
❌ GitHub 서버 문제	특정 시간대에 GitHub 서버의 registry 또는 CDN 이슈로 인해 v2 다운로드 실패

---

✔️ 해결 방법: @v3 버전으로 변경

공식 문서 및 커뮤니티 보고에 따르면 actions/cache@v3는 아래와 같은 이점을 제공합니다:

• ✅ 메타데이터 로드 문제 없음
• ✅ 대부분의 runner와 호환성 보장
• ✅ Poetry, Python 환경에서도 안정적 작동

✅ 교체 예시

uses: actions/cache@v3

---

✨ 성공적으로 수정된 .yml 예시

- name: Cache Poetry
  uses: actions/cache@v3
  with:
    path: ~/.local/
    key: poetry-1.8.5

- name: Cache dependencies
  uses: actions/cache@v3
  with:
    path: /home/runner/.cache/pypoetry/virtualenvs/
    key: python-${{ steps.setup-python.outputs.python-version }}-poetry-${{ hashFiles('poetry.lock') }}-${{ hashFiles('pyproject.toml') }}-v1

💡 이처럼 단순히 @v2를 @v3로 변경하는 것만으로도 문제가 해결됩니다.

---

✅ 결과 정리

상황 결과

v2 사용 시	오류 발생 (다운로드 정보 누락)
v3 사용 시	문제 해결, 캐시 정상 동작

---

📌 마무리 정리

• actions/cache@v2 사용 시 Missing download info 오류가 발생하면,
• GitHub 서버 이슈 또는 버전 호환성 문제일 확률이 높습니다.
• 이럴 땐 즉시 @v3로 버전 업그레이드하면 대부분 해결됩니다.
• 현재 v3는 안정성과 호환성이 가장 뛰어난 버전입니다.

---

🚀 복잡해 보이는 GitHub Actions 오류도, 최신 버전 사용으로 쉽게 해결할 수 있습니다!