개발 · 점검 노트
패키징 오류가 날 때 먼저 볼 로그
마감 전날 패키징 버튼을 눌렀는데 몇 분 뒤 실패 알림만 뜨고 끝나는 일이 있습니다. 알림 창의 짧은 문구만 보고 프로젝트를 이리저리 고치면 시간만 흘러갑니다. 실패의 이유는 거의 언제나 로그 안에 적혀 있고, 어디부터 읽느냐가 해결 속도를 정합니다.
작업 노트 511 · 읽는 시간 약 5분 · 2026.11.17 정리
실패 알림 창보다 출력 로그를 먼저 엽니다
패키징 실패 알림에 보이는 문구는 대개 '알 수 없는 오류'나 '쿡 실패'처럼 결과만 알려 줍니다. 원인은 에디터의 출력 로그(Output Log) 창에 쌓인 긴 기록 속에 있습니다. 실패 알림이 뜨면 창을 닫기 전에 출력 로그를 열고, 패키징을 시작한 시점부터 끝난 시점까지를 한 덩어리로 보는 것이 첫 번째 점검 항목입니다.
로그를 처음부터 끝까지 읽을 필요는 없습니다. 검색 칸이나 필터에서 Error라는 단어로 걸러 보면 수천 줄이 수십 줄로 줄어듭니다. 여기서 중요한 것은 맨 아래가 아니라 맨 처음 나온 오류 줄입니다. 뒤쪽 오류는 앞의 실패 때문에 연달아 생긴 결과인 경우가 많아서, 첫 줄을 고치면 나머지가 함께 사라지기도 합니다.
경고(Warning)는 일단 미뤄 둡니다. 경고가 수백 개여도 패키징은 성공할 수 있고, 실패를 만드는 것은 대부분 오류 줄입니다. 다만 같은 에셋 이름이 경고와 오류에 반복해서 나온다면 그 에셋이 범인일 가능성이 높으니 메모해 둡니다. 이 메모가 다음 단계에서 어느 파일을 열어 볼지 정하는 기준이 됩니다.
빌드에서 막혔는지, 쿡에서 막혔는지 구분합니다
언리얼의 패키징은 한 번에 끝나는 일이 아니라 여러 단계가 이어진 작업입니다. 실행 파일을 컴파일하는 빌드, 에셋을 대상 플랫폼이 읽을 수 있는 형태로 바꾸는 쿡, 결과물을 따로 모으는 스테이지, 배포 형식으로 묶는 패키지 순서입니다. 로그에서 오류 줄 바로 위를 보면 지금 어느 단계였는지 대개 드러납니다.
빌드 단계에서 멈췄다면 코드 문제를 먼저 의심합니다. C++ 클래스를 추가한 프로젝트에서 에디터에서는 돌아가던 코드가 패키징 때 컴파일되지 않는 경우가 있습니다. 에디터 전용 기능을 게임 코드에서 부르고 있지 않은지, 플러그인이 대상 플랫폼을 지원하는지, 오류 줄에 적힌 파일 이름과 줄 번호부터 확인합니다.
쿡 단계에서 멈췄다면 에셋 문제일 가능성이 큽니다. 지워진 에셋을 아직 참조하는 블루프린트, 이름을 바꾼 뒤 정리되지 않은 리다이렉터, 깨진 머티리얼이 흔한 원인입니다. 오류 줄에 적힌 에셋 경로를 콘텐츠 브라우저에서 찾아 직접 열어 보고, 열리지 않거나 컴파일 오류가 뜨면 그 에셋을 먼저 고칩니다.

에디터를 닫아도 남는 로그 파일 위치
에디터가 멈추거나 실수로 창을 닫아 출력 로그를 놓쳤다면 프로젝트 폴더의 Saved 안에 있는 Logs 폴더를 엽니다. 에디터 세션마다 기록이 텍스트 파일로 저장되고, 이전 세션의 파일도 날짜가 붙은 이름으로 남습니다. 수정한 날짜가 가장 최근인 파일부터 메모장으로 열어 같은 방식으로 Error를 검색합니다.
로그 파일은 질문할 때도 쓸모가 있습니다. 강사나 팀원에게 '패키징이 안 돼요'라고만 말하면 상대도 처음부터 다시 재현해야 합니다. 첫 오류 줄과 그 위아래 스무 줄 정도를 함께 보여 주면 대화가 훨씬 짧아집니다. 오류 문구를 그대로 복사해 공식 포럼에서 검색하는 것도 이때 바로 할 수 있습니다.
패키징된 실행 파일이 켜지자마자 꺼지는 경우는 별개의 문제입니다. 패키징은 성공했지만 실행 중에 오류가 난 것이라 에디터 로그에는 원인이 없을 수 있습니다. 이때는 패키징 결과 폴더 안에 생기는 저장 폴더와 크래시 기록을 찾아봐야 하고, 개발용 설정으로 다시 패키징해 로그가 더 많이 남도록 하는 방법을 씁니다.
로그에서 자주 보이는 원인과 고치는 순서
- 참조 깨짐: 삭제한 에셋을 다른 블루프린트가 여전히 가리킴 → 레퍼런스 뷰어로 연결을 찾아 참조를 교체하거나 지웁니다.
- 리다이렉터 잔여물: 폴더 이동 뒤 남은 연결 파일 → 폴더에서 리다이렉터 정리 기능을 실행합니다.
- 블루프린트 컴파일 오류: 에디터에서는 경고로 넘어간 노드 → 해당 블루프린트를 열어 컴파일하고 빨간 노드를 고칩니다.
- 경로 문제: 폴더 깊이가 깊거나 한글·특수문자가 섞인 이름 → 프로젝트를 짧은 영문 경로로 옮겨 다시 시도합니다.
원인을 고친 뒤에는 바로 전체 패키징을 다시 돌리기보다 작은 확인부터 합니다. 문제의 블루프린트를 다시 컴파일하고 저장한 뒤 에디터를 한 번 껐다 켜서 오류가 사라졌는지 봅니다. 그다음 패키징을 돌려야 같은 실패로 몇십 분을 다시 기다리는 일을 줄일 수 있습니다.
한 번에 여러 곳을 고치지 않는 것도 중요합니다. 세 군데를 동시에 바꾸고 성공하면 무엇이 원인이었는지 모르고, 실패하면 새 문제가 생긴 것인지 구분이 안 됩니다. 첫 오류 하나를 고치고 다시 돌리는 순서를 지키면 느려 보여도 결과적으로 더 빨리 끝납니다. 고친 내용은 작업 노트에 한 줄씩 적어 둡니다.

마감 전날 실패하지 않도록 미리 하는 습관
패키징 오류가 무서운 이유는 대부분 마감 직전에 처음 패키징을 해 보기 때문입니다. 프로젝트 초반, 아직 레벨이 하나뿐일 때 한 번 패키징해 두면 설정 문제를 일찍 발견합니다. 이후로도 큰 기능을 붙일 때마다, 적어도 일주일에 한 번은 패키징해 실행해 보는 일정을 잡아 두면 오류가 쌓이지 않습니다.
버전 관리 도구로 패키징이 성공한 시점을 표시해 두는 것도 도움이 됩니다. 어제는 되던 패키징이 오늘 실패하면, 어제 이후 바뀐 파일 목록만 보면 범위가 좁혀집니다. 기록이 없으면 프로젝트 전체를 의심해야 하지만, 기록이 있으면 바뀐 블루프린트 몇 개만 열어 보면 됩니다.
로그를 읽는 일은 처음엔 낯설지만 몇 번 해 보면 어디를 볼지 눈에 익습니다. 언리얼 수업에서도 포트폴리오를 영상과 실행 빌드로 정리하는 단계가 있어 패키징 실패를 직접 마주하게 됩니다. 혼자서 로그를 봐도 원인을 좁히기 어렵다면 SBS아카데미게임학원 언리얼 과정 무료 상담에서 지금 막힌 지점과 배우고 싶은 범위를 함께 이야기해 보세요.
자주 묻는 질문
패키징 시간이 너무 오래 걸리는데 정상인가요?
첫 패키징은 쿡할 에셋이 많아 오래 걸리는 편이고, 이후에는 바뀐 부분 위주로 처리되어 짧아지는 경우가 많습니다. 쓰지 않는 에셋을 정리하면 쿡 대상도 줄어듭니다.
블루프린트만 쓴 프로젝트도 빌드 단계 오류가 나나요?
코드를 직접 쓰지 않았어도 플러그인이나 플랫폼 설정 때문에 빌드 단계에서 멈출 수 있습니다. 이때도 첫 오류 줄의 파일 이름을 보고 어느 플러그인인지 확인합니다.
확인한 자료
- Epic Developer Community - Build Operations: Cooking, Packaging, Deploying, and Running Projects
- Epic Developer Community - Asset Redirectors in Unreal Engine
외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.
과정 보기 →