로그에는 7건이 찍혔는데, 초안은 딱 1개만 나왔다
영상감지로그엔 신규 영상 7건이 쌓여 있었는데, 다음 날 발행초안 시트엔 1건뿐이었다. 에러도 없이 조용히 1건만 처리되고 있던 원인을 찾고 나니, 운영 규칙 문서와 코드가 또 따로 놀고 있었다.
어느 날 아침 구글시트를 열어 보니 이상했습니다. “영상감지로그” 탭에는 밤사이 신규 영상이 7건이나 쌓여 있는데, 초안이 모이는 “발행초안” 탭에는 딱 1건만 있었습니다. 에러 알림도 안 왔습니다. 스크립트가 조용히 잘 돌긴 돈 모양인데, 숫자가 안 맞았습니다.
어디서 6건이 사라졌나
처음엔 “나머지 6건 처리 중에 뭔가 실패했나” 싶어서 로그부터 뒤졌습니다. 에러는 한 줄도 없었습니다. 영상 다운로드, 자막 추출, Claude 호출까지 전부 정상 종료 표시였습니다. 그런데 처리된 건 1건뿐이었습니다.
코드를 처음부터 다시 읽다가 이 줄을 발견했습니다.
pending = pending[: CONFIG["MAX_DRAFTS_PER_RUN"]]
감지된 영상 목록 중 앞에서부터 MAX_DRAFTS_PER_RUN개만 잘라서 처리한다는 뜻입니다. 그 값을 확인해 보니 1로 설정돼 있었습니다. 나머지 6건이 “실패한 게” 아니라, 애초에 처리 대상에 포함조차 되지 않았던 것이었습니다. 실행할 때마다 딱 1건씩만 처리하고 있었으니, 매일 쌓이는 양보다 처리하는 양이 적었던 셈입니다.
운영 규칙 문서와 코드가 또 어긋나 있었다
예전에 구글시트 행을 지웠다가 중복 감지가 무력화된 적이 있는데, 그때도 “문서에 적은 숫자”와 “코드에 들어간 숫자”가 따로 놀았던 게 원인이었습니다. 이번에도 같은 모양이었습니다. 운영 규칙 문서에는 분명 “하루 최대 3건까지 초안을 쓴다”고 적어 뒀는데, 코드의 MAX_DRAFTS_PER_RUN은 1이었습니다.
왜 이렇게 됐는지 정확한 경위는 기억이 흐릿합니다. 짐작으로는, 스크립트를 처음 테스트할 때 “일단 1건만 돌려서 결과를 확인해 보자” 하고 1로 맞춰 뒀다가, 그 뒤 운영 규칙에는 3건으로 정해 놓고도 코드 쪽 숫자는 미처 못 바꾸고 넘어간 것 같습니다. 문서와 코드를 같이 보지 않고 따로 고친 게 문제였습니다.
pending = pending[: CONFIG["MAX_DRAFTS_PER_RUN"]] # 1 → 3으로 수정
덤으로 발견한 또 하나의 사각지대
원인을 찾는 과정에서 하나를 더 발견했습니다. Claude 응답 JSON 파싱이 간헐적으로 실패할 때, 그 실패를 조용히 삼키고 다음 날 재시도만 하도록 짜여 있었습니다. 실패 자체를 알려 주는 알림이 없다 보니, “처리량이 적은 게 설정값 때문인지, 중간에 뭔가 실패하고 있는 건지” 구분할 방법이 없었습니다. 이참에 영상 하나라도 처리에 실패하면 텔레그램으로 바로 알림이 오도록 추가했습니다. 다음엔 “조용히 숫자가 안 맞는” 상황 자체가 덜 생기게 하려는 조치입니다.
돌아보며
이번이 “문서에 적은 숫자와 코드 속 숫자가 어긋난” 두 번째 사건입니다. 한 번은 우연일 수 있지만, 두 번째부터는 패턴입니다. 그래서 앞으로는 운영 규칙 문서에서 숫자를 하나 바꿀 때마다, 그 숫자를 실제로 쓰는 코드 쪽 변수도 같이 열어서 확인하는 걸 루틴으로 만들기로 했습니다.
그리고 “에러가 없다”는 게 “제대로 돌아가고 있다”는 뜻은 아니라는 것도 다시 느꼈습니다. 스크립트는 설정된 값(1건) 기준으로는 완벽하게 정상 동작하고 있었습니다. 문제는 그 설정값 자체가 제가 의도한 값이 아니었다는 것뿐이었습니다. 로그에 에러가 없어도, 가끔은 “결과물 숫자가 기대한 만큼 나왔는지”를 따로 세어 보는 확인이 필요합니다.