4,314자 메시지 하나가 같은 헤더를 수십 통 쌓았다 초안
Message is too long
발송 실패의 원인으로 로그에 남아 있던 오류는 이 한 줄이었다. 채팅에서 보인 것은 달랐다. 2026년 10월 초, 아침 7시부터 한 채팅에 똑같은 헤더 메시지가 약 70초 간격으로 계속 올라왔고, 알아챘을 때는 이미 수십 통이 쌓여 있었다.
커뮤니티용 텔레그램 봇에는 정해진 시각에 헤더 메시지 하나와 본문 여러 조각을 차례로 보내는 예약 발송이 있다. 길이 제한을 넘은 것은 본문 조각 하나였는데 쌓인 것은 헤더였다. 원인은 두 겹이었다.
그날 한 조각이 4,314자였다
텔레그램 sendMessage의 본문은 4096자까지다. 이 발송의 본문 조각들은 그때그때 데이터에서 만들어지고, 그날 한 조각이 4,314자였다. 길이를 정하는 쪽이 데이터라서, 데이터가 늘면 코드를 건드리지 않아도 어느 날 제한을 넘는다.
봇에는 긴 텍스트를 4096자 단위로 나누는 헬퍼가 이미 있었다. 이 발송 경로에는 그것이 빠져 있었다.
재시도는 매번 헤더부터 다시 보냈다
고치기 전 코드는 대략 이런 모양이었다.
try:
await bot.send_message(chat_id=chat, text=header)
for name, body in parts:
await bot.send_message(chat_id=chat, text=body)
except Exception:
logger.exception("send failed") # 미표시 → 다음 틱에 재시도
continue
ledger.mark(key)
헤더와 본문 조각 전체가 하나의 try 안에 있고, 전부 성공해야 원장에 “보냄”이 찍힌다. 중간에 하나라도 실패하면 원장에 찍히지 않은 채로 넘어간다. 그리고 이 예약 발송은 24시간 유예 창 안에서는, 원장에 찍혀 있지 않으면 틱이 돌 때마다 다시 시도하게 되어 있었다.
실패하면 미표시로 남겨 다음 틱에 다시 시도하는 것까지는 일부러 넣은 동작이다. 다만 재시도의 단위가 “전체”였다. 실패한 조각부터 이어 가지 않고 헤더부터 다시 보낸다. 헤더는 매번 성공하고, 4,314자 조각은 매번 실패한다. 틱마다 헤더가 한 통씩 쌓였다.
길이 초과는 결정적인 실패이기도 하다. 같은 텍스트를 다시 보내면 몇 번을 해도 같은 결과가 나온다. 다음에는 될 수도 있다는 가정 위에 만든 재시도였으니 유예 창이 끝날 때까지 멈출 이유가 없었다. 유예 창이 24시간이었으니 그대로 뒀다면 하루 종일 쌓였을 구조다.
원장에 찍는 자리를 헤더 직후로 옮겼다
두 가지를 같이 고쳤다.
try:
await bot.send_message(chat_id=chat, text=header)
except Exception:
logger.exception("send failed") # 미표시 → 다음 틱에 재시도
continue
ledger.mark(key) # 헤더가 나간 뒤로는 재시도하지 않는다
failed = []
for name, body in parts:
try:
for chunk in split_message(body): # 4096자 단위
await bot.send_message(chat_id=chat, text=chunk)
except Exception:
logger.exception("part %s failed", name)
failed.append(name)
원장에 찍는 시점을 “전부 성공한 뒤”에서 “헤더가 나간 직후”로 옮겼다. 헤더 발송이 실패하면 예전처럼 미표시로 남아 다음 틱에 다시 시도한다. 이 시점에는 아직 채팅에 아무것도 나가지 않았으므로 재시도해도 중복이 생기지 않는다.
헤더가 나간 다음부터는 조각마다 따로 try로 감싼다. 한 조각이 실패해도 나머지 조각은 계속 보내고, 실패한 조각 이름은 모아서 발송 결과 로그 한 줄에 같이 남긴다. 예전 구조에서는 한 조각이 실패하면 그 뒤의 조각은 시도조차 되지 않았다.
발송 한 건이 두 구간으로 나뉜 셈이다. 헤더가 나가기 전은 실패하면 처음부터 다시 해도 되는 구간이고, 헤더가 나간 뒤는 실패해도 되돌아가지 않는 구간이다. 원장에 찍는 위치가 그 경계다.
분할은 보내기 직전에 넣었다
본문 조각을 보내는 모든 지점에서 분할 헬퍼를 거치게 했다. 예약 발송뿐 아니라 같은 본문을 수동 명령으로 받아 보는 경로도 똑같이 길이 제한에 걸릴 수 있어서 함께 고쳤다.
고칠 지점은 생각보다 여러 곳이었다. 예약 발송은 설정에 따라 조각을 담당자 DM으로 먼저 보내고, DM이 실패하면 공용 채팅으로 돌려 보낸다. 공용 채팅으로 갈 때는 조각 앞에 제목 한 줄이 더 붙으므로 같은 본문이라도 길이가 달라진다. 그래서 분할은 본문을 만드는 쪽에 두지 않고 보내기 직전, 실제로 나갈 텍스트가 정해진 자리에 넣었다. DM 경로와 채팅 경로 양쪽 모두다.
길이를 먼저 재서 긴 경우에만 나누는 분기는 두지 않았다. 모든 본문이 분할 함수를 거친다. 분기를 뒀다면 평소에 한 번도 실행되지 않던 코드가 긴 본문이 들어온 날 처음 돌게 된다.
빠진 조각은 다시 보내지 않는다
이 수정에는 대가가 있다. 헤더가 나간 뒤에 실패한 조각은 자동으로 다시 보내지 않는다. 일시적인 오류로 조각 하나가 빠져도 그날은 그대로 빠진 채로 끝나고, 로그에만 남는다.
조각 단위로 원장을 두고 실패한 조각만 재시도하는 방법도 있다. 이번에는 하지 않았다. 재시도가 헤더부터 다시 시작하는 지금 구조에서 고를 수 있는 것은 “빠진 조각 하나”와 “매 틱 쌓이는 헤더” 둘이었고, 사람이 보는 채팅방에서는 앞쪽이 덜 나쁘다고 판단했다. 빠진 조각은 수동 명령으로 다시 받아 볼 수 있지만, 수십 통 쌓인 메시지는 받은 쪽에서 치워야 한다.