타임존 없는 한 줄이 원장 저장을 멈췄다
... final check failed
스케줄러가 한 번 돌 때마다(틱마다) 이렇게 끝나는 로그 줄이 찍히고, 그 뒤에 같은 트레이스백이 쌓였다. 발송 자체는 정상으로 나가고 있었고 중복 발송도 없었다. 겉으로 보이는 피해가 없어서 로그 잡음처럼 보였다.
잡음이 아니었다. 2026년 9월 중순, 발송 원장이 디스크에 전혀 저장되지 않고 있었다.
1,495건 중 1건
커뮤니티용 텔레그램 봇은 정해진 시각에 메시지를 보내고, 같은 것을 두 번 보내지 않도록 발송 원장을 JSON 파일로 관리한다. 원장은 “발송 키 → 보낸 시각”의 dict다. 발송할 때마다 mark()가 호출되고, 이 함수는 메모리의 dict에 키를 넣고, 보관 기간이 지난 항목을 정리하고, 파일에 쓴다. 이 순서대로다.
정리 함수는 각 항목의 시각 문자열을 읽어 기준 시각(cutoff)과 비교한다.
for k, sent_at in self._sent.items():
try:
if datetime.datetime.fromisoformat(sent_at) >= cutoff:
kept[k] = sent_at
except ValueError:
kept[k] = sent_at # 못 읽는 값: 지우지 말고 보존
봇이 직접 쓰는 시각에는 항상 타임존이 붙는다. 그런데 운영 중인 원장 1,495건 가운데 딱 1건에 타임존이 없었다. 예전에 중복 발송을 막으려고 사람이 손으로 끼워 넣은 항목이었다.
파이썬의 datetime에는 타임존 정보가 있는 aware 객체와 없는 naive 객체가 있고, 둘을 크기 비교하면 TypeError: can't compare offset-naive and offset-aware datetimes가 난다. cutoff는 aware였다. 손으로 넣은 항목은 naive로 읽혔다.
위 코드의 except ValueError는 fromisoformat이 문자열을 못 읽는 경우를 대비한 것이다. 타임존 없는 문자열은 파싱에는 성공한다. 실패하는 곳은 그다음의 비교이고 거기서 나는 예외는 TypeError다. 파싱과 비교가 한 try 안에 있어서 대비가 된 것처럼 보였을 뿐이다.
예외는 정리 함수를 빠져나가 mark()를 중단시켰다. 메모리에는 들어갔지만 파일 쓰기에는 도달하지 못했다. 그 한 줄이 원장에 들어간 뒤로는 어떤 발송도 디스크에 기록되지 않았다.
재시작 한 번이면 전부 되살아날 상태였다
프로세스가 살아 있는 동안은 메모리의 dict가 중복을 막아 준다. mark()가 예외로 끝나도 키는 이미 메모리에 들어가 있기 때문이다. 그래서 보이는 것은 트레이스백뿐이었다.
새 프로세스는 파일에서 원장을 읽는다. 파일에는 문제가 생긴 시점 이후의 발송이 하나도 없으니, 그 사이에 보낸 것이 전부 “안 보낸 것”으로 되살아난다. 이 봇은 하루에도 몇 번씩 배포한다. 중복 발송까지 한 걸음 거리였다.
커밋 기록에는 실제로 중복 발송이 나갔다는 내용은 없다. 트레이스백의 원인을 따라가다 먼저 발견했다.
파싱과 비교를 떼어 냈다
타임존이 없으면 로컬 타임존(코드의 TZ)으로 읽는다.
for k, sent_at in self._sent.items():
try:
when = datetime.datetime.fromisoformat(sent_at)
except (TypeError, ValueError):
kept[k] = sent_at # 못 읽는 값: 지우지 말고 보존
continue
if when.tzinfo is None:
when = when.replace(tzinfo=TZ) # 손으로 넣은 naive 값
if when >= cutoff:
kept[k] = sent_at
naive 값을 로컬 시각으로 해석한 것은 그 값을 넣은 주체가 사람이기 때문이다. 사람은 자기 시계에 보이는 시각을 적는다. 파싱조차 안 되는 값은 예전처럼 그대로 남긴다. 정리 함수가 해석할 수 없는 항목을 지워 버리면 그 키의 중복 방지가 사라진다.
테스트는 naive 항목이 섞인 원장 파일을 만들어 놓고 네 가지를 확인한다. mark()가 예외 없이 끝나는지, 새 항목이 실제로 파일에 있는지, 30일 지난 naive 항목은 정리되고 오늘 것은 남는지, ISO 형식이 아닌 값이 그대로 남는지다. 두 번째가 핵심이다. 예외가 안 나는 것만 확인해서는 저장을 건너뛰지 않았다는 보장이 없다.
두 시간 뒤, 로그의 시각이 9시간 어긋나 있었다
원장을 고치고 두 시간 뒤에 시각 문제를 하나 더 고쳤다. 이번에는 계산은 맞고 로그가 틀렸다.
봇에는 정해진 시각에 시작하는 예약 작업이 있고, 그 작업이 끝난 뒤 얼마간 기다렸다가 외부 API에서 결과를 읽는다. 23:00에 시작한 건에 대해 로그에는 “15:45에 끝났다, 16:03부터 읽는다”가 남았다. 실제로는 00:45에 끝나 01:03부터 읽었다. 외부 API가 주는 종료 시각이 UTC였고, 그것을 변환 없이 %H:%M으로 찍었다.
판단은 처음부터 정확했다. 비교하는 두 시각이 모두 aware라서 타임존이 달라도 올바르게 비교된다. 틀린 것은 사람이 읽는 표시뿐이었다. 하지만 이 작업에서 가장 흔한 실패가 “엉뚱한 회차를 붙잡는 것”이었고, 9시간 어긋난 시각이 찍힌 로그는 그 실패처럼 보였다. 정상 동작을 버그로 오인하게 만드는 로그였다.
찍는 자리에서만 변환했다.
logger.info("%s: %s에 끝났다, %s부터 읽는다 (KST)",
name,
f"{ended.astimezone(TZ):%H:%M}",
f"{ready_at.astimezone(TZ):%H:%M}")
내부 값은 건드리지 않았다. 문구 끝에 타임존 이름도 붙였다. 시각만 찍힌 로그는 읽는 사람이 타임존을 추측해야 한다.
7월에는 반대 방향으로 틀렸다
두 달 전인 7월에 고친 것은 주간 집계다. 항목의 생성 시각을 날짜로 귀속할 때 UTC ISO 문자열의 앞 10자를 그대로 잘라 날짜로 쓰고 있었다.
한국 시간은 UTC보다 9시간 빠르다. KST 자정부터 오전 9시 사이에 만들어진 항목은 UTC로는 아직 전날이다. 문자열을 자르면 그 항목이 전날로 귀속되고, 월요일 새벽에 만들어진 항목은 지난주 집계로 들어간다. 다른 보고서는 KST 기준으로 날짜를 계산하고 있어서 같은 항목이 보고서마다 다른 날에 잡혔다.
def _created_date_local(s: str) -> datetime.date | None:
try:
dt = datetime.datetime.fromisoformat(s.replace("Z", "+00:00"))
except (ValueError, TypeError):
return None
if "T" not in s:
return dt.date() # 시각 없는 순수 날짜는 그대로
if dt.tzinfo is None:
dt = dt.replace(tzinfo=datetime.timezone.utc)
return dt.astimezone(TZ).date() # 타임존을 맞춘 뒤에 날짜로 자른다
여기서는 타임존 없는 값을 UTC로 읽는다. 원장에서는 naive 값을 로컬 시각으로 읽었으니 반대다. 이 값은 외부 API가 준 것이고 그 API는 UTC를 쓴다. 원장의 값은 사람이 적었다.