자동으로 만든 숏폼 영상이 중간에 멈추거나 깨지면 다들 재시도 버튼부터 누른다. 숏폼 영상 자동 렌더링 실패 원인을 따지기 전에 한 번 더 돌려보는 것이다. 원클립AI에서 자동 렌더를 돌릴 때도 나는 똑같이 했다. 재시도로 살아나는 경우가 있고, 같은 쇼츠가 같은 자리에서 또 죽는 경우도 있다. 둘을 구분할 근거가 없으니 불안했다.
지난 30일 동안 숏폼 자동 제작 파이프라인의 작업 폴더가 253개 쌓였고, 유튜브 쇼츠용 자동 렌더 영상이 39편 나왔다. 이 정도 양이면 실패를 하나씩 감으로 보기는 어렵다. 이 글은 재시도할지, 입력을 고칠지, 서버를 키울지를 로그에서 가르는 기준을 정리한다.
재시도를 눌러도 같은 쇼츠가 또 죽는 이유
자동 생성 영상이 중간에 멈출 때 떠오르는 질문들
이때 머릿속에 떠오르는 질문은 대개 두 가지다. 코드 버그인가, 아니면 서버가 힘든 건가. 그런데 로그가 없으면 어느 쪽인지 말할 방법이 없다. 입력 파일이 이상한 경우도 있어서 셋 중 무엇인지에 따라 할 일이 전부 달라진다.
재시도가 통하는 경우와 아닌 경우를 먼저 나눠야 하는 이유
재시도는 같은 명령을 다시 실행하는 것이다. 원인이 타이밍이나 일시적인 자원 부족이었다면 결과가 달라질 수 있다. 원인이 입력 파일 안에 있다면 몇 번을 돌려도 같은 지점에서 같은 에러가 난다. 그래서 재시도 전에 이 둘을 먼저 가려야 한다.
가장 먼저 확인할 로그 항목 5가지
로그에 안 남기면 판단할 수가 없다. 작업이 끝날 때 아래 다섯 가지가 한 줄에 같이 남도록 맞춰두는 걸 권한다.
- 종료 코드: 0이 아니면 실패다. 137은 보통 강제 종료 신호를 받았다는 뜻이라 메모리 부족을 먼저 의심한다.
- 마지막 진행 단계와 위치: 인코딩 중이었는지, 오디오를 합치던 중이었는지, 몇 프레임째에서 죽었는지.
- 맨 처음 찍힌 에러 줄: 뒤쪽 줄은 연쇄 실패라서 원인이 아닌 경우가 많다.
- 입력 파일 정보: 경로, 크기, 길이, 코덱.
- 실행 시점의 메모리와 디스크 여유: 같은 작업이라도 이 값에 따라 결과가 갈린다.
형식만 맞춘 예시를 보면 이렇다. 실제 로그를 그대로 옮긴 건 아니고, 판단 순서를 보여주려고 만들었다.
[03:12:44] job=shorts_a1 step=encode exit=137 last_frame=1834 in=/work/shorts_a1/src.mp4 size=48213KB
[09:40:02] job=shorts_b2 step=encode exit=1 first_err="Unknown encoder 'libx265'" in=/work/shorts_b2/src.mov
[14:05:17] job=shorts_c3 step=probe exit=1 first_err="Invalid data found when processing input" in=/work/shorts_c3/src.mp4
첫 줄은 중간 이후에 죽었으니 메모리부터 본다. 둘째 줄은 처음부터 인코더가 없다고 한다. 설치나 설정 문제라서 재시도는 의미가 없다. 셋째 줄은 입력을 읽는 probe 단계에서 막혔으니 파일을 의심한다. 로그 한 줄이면 이 정도는 바로 갈린다.
재시도로 풀리는 실패와 소용없는 실패를 구분하는 기준
일시적 실패와 재현되는 실패
일시적 실패는 네트워크가 끊기거나, 업로드가 타임아웃되거나, 임시 디스크가 잠깐 찼거나, 다른 작업과 자원을 나눠 쓰다 밀린 경우다. 조건이 바뀌면 사라진다. 재현되는 실패는 같은 입력의 같은 지점에서 항상 죽는다. 이때 재시도는 시간만 쓴다.
재시도 횟수와 간격을 정하는 기준
나는 재시도를 한 번만 한다. 한 번 더 돌려도 살아나지 않으면 조건보다 입력 쪽 문제일 가능성이 높다고 본다. 무한 재시도는 생각보다 해롭다. 메모리를 많이 먹는 작업이 같은 자리에서 계속 다시 뜨면, 옆에서 돌던 작업까지 밀려서 죽는다. 재시도가 서버를 더 나쁘게 만드는 셈이다.
| 상황 | 판정 | 할 일 |
|---|---|---|
| 같은 입력이 같은 프레임에서 항상 죽음 | 재현되는 실패 | 재시도 중단, 입력과 설정 확인 |
| 같은 입력인데 혼자 돌리면 성공 | 자원 경합 | 동시 실행 줄이고 1회 재시도 |
| 업로드나 다운로드 단계 타임아웃 | 일시적 실패 | 1회 재시도 후 격리 |
| exit 137, 중간 이후 갑자기 종료 | 자원 부족 | 재시도 말고 동시 실행 줄이기 |
솔직히 말하면 이 표는 아직 가설이다. 같은 입력을 여러 번 돌려 결과 차이를 기록하는 실험을 제대로 해본 적이 없다. 다음으로 할 일이 그 실험이다.

메모리 부족, 코덱 문제, 입력 파일 문제의 증상 구별법
| 원인 | 증상 | 로그 단서 | 해결 방향 |
|---|---|---|---|
| 메모리 부족 | 중간 이후 갑자기 종료 | exit 137, dmesg에 Out of memory 흔적 | 동시 실행 줄이기, 해상도와 비트레이트 낮추기 |
| 코덱 문제 | 특정 포맷이나 프로파일에서만 실패 | Unknown encoder, Decoder not found | 설치 확인, 입력을 표준 포맷으로 변환 |
| 입력 파일 문제 | 처음부터 또는 특정 지점에서 실패 | Invalid data found, 오디오 트랙 없음, 길이 0 | 업로드 단계에서 거부하거나 정규화 |
가변 프레임레이트(VFR) 영상은 싱크가 밀리다가 끝에서 길이가 어긋나서 코덱 문제처럼 보이기도 한다. 세 원인은 겹칠 수 있다. 메모리가 빠듯한 서버에서 VFR 입력을 처리하면 두 문제가 한꺼번에 나온다. 어느 쪽이 먼저인지는 아직 깔끔하게 구분하지 못했다. 지금은 같은 입력을 메모리 여유가 큰 환경에서 따로 돌려서 확인한다.

원인을 좁힌 뒤 같은 영상이 다시 깨지지 않게 바꿀 것
입력 정규화
업로드 단계에서 코덱, 프레임레이트, 오디오를 한 가지로 맞춘다. 원본을 그대로 렌더러에 넘기지 않는 게 기준이다.
ffmpeg -i src.mov -c:v libx264 -pix_fmt yuv420p -r 30 -fps_mode cfr -c:a aac -ar 48000 -b:a 128k norm.mp4
프리플라이트 검사
렌더 전에 입력을 검사하는 스크립트를 먼저 돌린다. 검사 항목은 이렇다.
- 파일이 존재하고 0바이트가 아닌지
- 비디오 스트림과 오디오 스트림이 모두 있는지
- 코덱과 해상도가 표준 설정과 맞는지
- avg_frame_rate와 r_frame_rate가 같은지, 다르면 VFR로 본다
- 여유 디스크가 충분한지
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,width,height,r_frame_rate,avg_frame_rate -of csv=p=0 src.mov
작업 격리
작업마다 자기 폴더를 쓰고, 실패한 작업은 큐에서 빼서 따로 모아둔다. 임시 파일은 작업이 끝나면 지운다. 실패 폴더와 임시 파일이 쌓이는 걸 막으려면 정리 주기를 정해야 하는데, 그 주기 값은 아직 정하지 못했다.
이 설정을 적용한다고 실패가 사라지지는 않는다. 설정 전후로 실패가 얼마나 줄었는지 비교할 데이터가 아직 없어서, 효과를 단정하지 않겠다.

작은 서버와 1인 환경에서 렌더링을 안정적으로 돌리는 기준
2026년 10월 6일 기준으로 크론이 서버에 70개, 노트북에 9개 돌고 있다. 작업 폴더도 서버 41개, 노트북 35개로 흩어져 있다. 혼자 이걸 보려면 실패가 조용히 쌓이지 않는 구조가 먼저다.
동시 실행 수와 큐
기본값은 동시 실행 1개다. 렌더는 CPU와 메모리를 많이 쓰기 때문에 두 개를 붙이면 실패 원인이 서로 섞인다. 큐는 쌓여도 되지만 실행은 한 줄로 세운다.
디스크 여유 공간과 임시 파일 정리
디스크가 차면 렌더는 깨진 파일을 남기고 끝나기도 한다. 여유 공간이 기준 아래로 내려가면 새 작업을 받지 않도록 임계치를 둔다. 임계치 숫자는 디스크 크기에 따라 달라서 여기서는 정하지 않겠다.
서버를 키울지, 작업을 나눌지
동시 실행을 1로 묶었는데도 큐가 계속 밀리면 그때 서버 사양을 본다. 원인이 메모리 부족이면 키우는 게 맞다. 원인이 입력 파일이면 키워도 같은 실패가 반복된다. 무인으로 도는 작업일수록 실패를 아침에야 알아채는 구조는 피해야 한다. 최소한 exit 값이 0이 아니면 job 이름과 함께 알림이 가도록 해두는 편이 낫다. 대용량 파일을 실시간으로 처리해야 하는 작업이라면 이 기준은 맞지 않는다. 그건 다른 구조가 필요하다.
요약 체크리스트와 오늘 바로 할 일
실패 시 5단계 진단 순서
- 종료 코드를 본다.
- 마지막 진행 단계와 위치를 본다.
- 맨 처음 찍힌 에러 줄을 본다.
- 입력 프리플라이트 결과를 본다.
- 실행 시점의 메모리와 디스크 여유를 본다.
재시도 여부 판정 한 줄
같은 입력과 같은 위치에서 재현되면 재시도하지 말고 입력을 고친다. 자원 상황에 따라 달라지면 1회만 재시도한다. 137이나 중간 종료가 반복되면 동시 실행을 줄이고 서버를 본다.
다음 주에 적용할 설정 3가지
- 동시 실행 1개로 고정하기
- 렌더 전에 프리플라이트 검사 스크립트를 항상 거치게 하기
- exit 값이 0이 아니면 job 이름과 함께 알림 보내기
이 기준을 다 검증한 건 아니다. 다음 달에 실패 로그를 모아서 판정표가 맞았는지 다시 적어볼 생각이다. 만든 것들과 작업 기록은 https://wallenstein.dev에 정리해 두었다.
출처와 근거 자료
혼자 자동화로 서비스를 굴리는 아일리고입니다. 숏폼 영상은 제가 만든 ClipSquare 로 뽑습니다.
궁금해할 만한 것들
숏폼 영상 자동 렌더링이 중간에 멈추면 재시도부터 눌러도 되나요?
일시적인 원인이면 한 번 재시도해서 살아나는 경우가 있습니다. 같은 입력이 같은 지점에서 계속 죽는다면 재시도는 시간만 잡아먹습니다. 그래서 저는 재시도를 한 번만 하고, 안 되면 로그부터 봅니다.
숏폼 렌더링 실패 원인은 로그의 어디를 보면 되나요?
종료 코드, 마지막으로 진행된 단계와 위치, 맨 처음 찍힌 에러 줄, 입력 파일 정보, 실행 당시 메모리와 디스크 여유 다섯 가지를 봅니다. 뒤쪽 에러는 앞 실패의 연쇄인 경우가 많아서 맨 앞 에러 줄이 원인에 더 가깝습니다.
종료 코드 137은 무슨 뜻인가요?
보통 프로세스가 강제 종료 신호를 받았다는 뜻이라서 메모리 부족을 먼저 의심합니다. 인코딩 중이거나 중간 이후에 갑자기 끊겼다면 재시도보다 동시 실행 수를 줄이는 쪽이 맞습니다. dmesg에 Out of memory 흔적이 있는지도 같이 확인하세요.
재시도로 풀리는 실패와 소용없는 실패는 어떻게 구분하나요?
같은 입력을 혼자 돌렸을 때 성공하면 다른 작업과 자원을 다퉈서 생긴 문제일 가능성이 큽니다. 같은 프레임에서 항상 죽는다면 입력 파일이나 설정을 의심해야 합니다. 네트워크 타임아웃처럼 조건이 바뀌면 사라지는 실패만 재시도 대상으로 봅니다.
Unknown encoder 같은 에러가 나면 어떻게 하나요?
처음부터 인코더를 찾지 못한다는 에러는 설치나 설정 문제라서 재시도로는 절대 풀리지 않습니다. 사용하는 인코딩 도구 빌드에 해당 코덱이 들어 있는지 먼저 확인하세요. 설정을 고친 뒤 같은 작업을 한 번 다시 돌리면 됩니다.
자동 쇼츠 렌더링이 자주 실패하면 서버부터 키워야 하나요?
서버를 키우기 전에 동시 실행 수와 입력 파일 상태를 먼저 점검하는 편이 낫습니다. 메모리 부족으로 죽는 경우는 동시 작업을 줄이는 것만으로도 꽤 줄어듭니다. 입력 자체에 원인이 있는 재현 실패라면 서버를 키워도 같은 자리에서 또 죽습니다.
