GitHub Actions에서 파일이 없는데 업로드가 성공하는 이유와 해결 방법

한 장의 그림으로 이해하기

개념 비유다. 두 장면 모두 담당자 앞 파일 트레이가 비어 있다. 왼쪽은 경고 표지를 들고 통로 차단기가 올라가 있지만, 오른쪽은 손으로 멈춤을 알리고 차단기가 내려가 있다. 빈 트레이는 지정 경로에 맞는 파일이 없는 상태, 담당자는 업로드 액션, 열린 통로는 경고만 남기고 액션을 실패시키지 않는 정책, 닫힌 차단기는 오류로 액션을 실패시키는 정책에 대응한다. 도로 화살표는 통로 방향이며 파일 전송 성공을 뜻하지 않는다. 두 장면은 동일한 누락 조건의 정책 비교로 실제 실행 결과가 아니다. 워크플로 전체 종료 상태는 continue-on-error 등 다른 설정에도 영향을 받는다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

업무·자동화 · 판정 관망

그림을 글로 풀면

필수 보고서 누락을 오류로

지정 경로에 파일이 없어도 기본 업로드 정책은 경고만 남길 수 있습니다.

대상
GitHub Actions로 AI 평가 결과를 보관하는 개발자
무엇이 바뀜
if-no-files-found 기본값은 warn입니다.
왜 중요한가
단계 성공만 보고 보고서가 저장됐다고 오해할 수 있습니다.
지금 할 일
필수 결과에는 error 정책을 검토하고 파일 내용도 따로 확인합니다.
한계·미확인
개념 비유. Actions 실행·보고서 생성 시험 없음.
공식 출처
github.com
확인일
2026-10-04

파일이 없는데 업로드가 성공하는 이유는?

가상의 AI 평가 자동화에서 실행은 끝났는데 전달할 보고서가 없다고 생각해 봅니다. 생성 위치를 잘못 지정했거나 앞선 단계가 보고서를 만들지 못했을 수 있습니다. 이 글은 실제 장애 보고가 아니라 필수 결과물을 놓치지 않기 위한 점검 제안입니다. 그림의 빈 트레이처럼 업로드 대상이 없는 상황을 액션이 어떤 종료 상태로 알리는지부터 확인합니다.

보고서 누락을 오류로 처리하는 방법

actions/upload-artifact의 공식 설명에서 if-no-files-found 기본값은 warn입니다. 지정한 경로에서 파일을 찾지 못하면 경고를 출력하지만 액션을 실패시키지는 않습니다. error로 지정하면 같은 조건에서 오류를 내며 액션이 실패합니다. ignore는 경고나 오류를 내지 않고 실패시키지 않는 선택입니다. 반드시 있어야 하는 평가 보고서라면 누락을 오류로 알리는 정책을 검토할 수 있습니다.

파일이 있으면 내용도 올바른가요?

error 설정은 지정 경로에 맞는 파일이 하나도 없는 조건을 다룹니다. 내용이 비어 있거나 이전 실행의 보고서가 남아 있는 상황까지 올바르게 판정한다는 뜻은 아닙니다. AINOW는 예상 경로와 실행 식별자, 보고서의 필요한 항목을 별도로 대조하도록 제안합니다. 또한 continue-on-error 등 주변 설정에 따라 워크플로 전체의 종료 표시는 달라질 수 있습니다. 이번에는 액션이나 평가 작업을 실행하지 않았으며 누락 탐지 효과를 실측하지 않았습니다.

참고 원문: GitHub actions/upload-artifact 공식 저장소 — if-no-files-found · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-04

AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.

이 글의 검증 카드

자료 버전
actions/upload-artifact 공식 README2026-10-04 확인, v7 예시의 if-no-files-found. 액션 설치·실행 및 워크플로 시험 없음
확인일
2026-10-04
검증 상태
개발자 주장
한계·주의
개념 비유. Actions 실행·보고서 생성 시험 없음.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.