만들다 막힌 곳을 적어 둡니다
개발자로 일하면서 퇴근 후에 웹사이트와 앱, 봇을 직접 만들고 운영합니다. 이 블로그에는 그 과정에서 직접 겪은 문제만 적습니다. 글마다 증상, 원인, 해결, 그리고 다음에 같은 일을 피하는 방법을 순서대로 적습니다.
최근 글
-
배포가 20분짜리 전사를 죽여서 게이트를 여섯 번 고쳤다 초안
하루에도 여러 번 재배포하는 텔레그램 봇에서 배포가 20분짜리 작업을 죽이고 저장을 반쯤 끊었다. 교체 직전에 무엇을 기다리고 무엇은 알리기만 할지, 8월 초부터 9월 하순까지 바뀐 순서대로.
-
하루 10~35번 재시작하는 봇, 메모리 상태를 디스크로 초안
배포할 때마다 컨테이너가 새로 만들어지는 텔레그램 봇에서 대기 상태와 로그가 조용히 사라졌다. 2026년 7월부터 11월까지, 사라진 걸 발견할 때마다 하나씩 파일로 옮겼다.
-
버튼 다섯 개를 눌렀는데 체크는 하나만 남았다 초안
텔레그램 인라인 버튼을 연달아 다섯 번 눌렀는데 상태 파일에는 체크가 하나만 남았다. 싱글 스레드 asyncio에서도 읽기와 쓰기 사이에 await가 있으면 덮어쓴다. 7월에 전역 락으로, 11월에 대화별 락으로 한 번씩 고쳤다.
-
목요일마다 빨개지는 CI, 날짜에 매인 테스트 세 건 초안
화요일에는 통과하던 테스트가 목요일부터 매주 실패해 배포가 막혔다. 요일과 시각을 박아 둔 테스트가 세 건 있었고, CI에서 한 번도 실행되지 않으면서 통과로 찍히던 테스트 파일도 하나 나왔다.
-
같은 435MB 영상을 124번 올린 durable job 초안
재시작해도 이어서 도는 작업에 재시도 상한이 없었다. 실패하는 작업 하나가 일주일 동안 같은 영상을 124번(약 54GB) 다시 올렸고, 석 달 뒤에는 같은 중복 확인이 용량 0인 객체를 '이미 있음'으로 판정했다.
-
백오프를 걸어 둔 Sheets 호출이 5xx 한 번에 죽었다 초안
gspread에 지수 백오프 클라이언트를 끼워 뒀는데도 503 한 번, 502 한 번에 명령이 실패했다. 백오프를 거치지 않는 호출이 하나 있었고, HTML로 온 5xx는 재시도 판정에서 빠지고 있었다.
-
SIGTERM 뒤 60초를 누가 얼마나 쓰는지 정했다 초안
배포 순간에 번역 두 건이 사라졌고, 10월 말에는 자동 발송이 두 목적지 중 한 곳에만 나갔다. 컨테이너 종료 유예 60초를 호출 유예 25초, 백그라운드 정리, 프레임워크 종료로 나눴다.
-
Sheets API 호출 14번을 1번으로 줄였다 초안
시트를 읽는 봇 명령이 느려서 재 보니 호출 1건이 약 0.3초였고 그 절반은 탭 메타데이터를 다시 받는 왕복이었다. 줄이고 나서 개별 읽기와 배치 읽기를 비교했더니 탭 4개의 결과가 달랐다.
-
재부팅 뒤 colima가 안 떴다, 17일 묵은 pid 파일 때문에 초안
맥미니를 재부팅했더니 봇 컨테이너가 하나도 뜨지 않았다. colima의 낡은 pid 파일이 엉뚱한 프로세스를 가리켰고, launchd는 실패한 colima를 다시 띄우지 않았다. 지금은 시작 래퍼가 pid 파일부터 치운다.
-
타임존 없는 한 줄이 원장 저장을 멈췄다 초안
원장 1,495건 중 손으로 넣은 1건에 타임존이 빠져 있었고, 그 뒤로 어떤 발송도 디스크에 기록되지 않았다. 같은 날 고친 UTC 로그와 7월에 고친 날짜 집계도 같이 적었다.