개발 이야기

중복 발송을 막았는데, 한 사람에게 문자가 몰릴 수 있었어요

같은 주문을 한 번 보내는 규칙과 같은 번호로 몰리는 발송을 제한하는 규칙은 달랐어요. 재현부터 보류·예외 승인까지 정리했어요.

사이트 공개일
기록 수정일
기술과 주제
Node.js · PostgreSQL · 멱등성 · 발송 제한
이 글의 목차

주문의 중복과 수신자의 반복은 달랐어요

사진 자동발송 시스템을 운영하기 시작한 뒤, 한 사람에게 문자가 수십 통 연속으로 갈 가능성을 점검했어요. 기존 구현에는 동일 작업의 중복 접수 방지가 있었어요. 여러 요청이 동시에 들어와도 한 번만 접수하고, 서버가 재시작되더라도 이미 남긴 발송 기록을 확인했죠.

하지만 검사 단위가 주문과 안내 종류였어요. 같은 사람이 서로 다른 주문을 여러 개 넣으면 각각은 정상적인 작업이에요. 모두 같은 전화번호를 쓰더라도 주문별 중복 검사를 통과할 수 있었어요.

이를 확인하려고 실제 문자를 보내지 않는 가상 발송사로 재현했어요. 같은 번호를 사용하는 서로 다른 주문 30건을 만들고 작업 처리 주기를 세 번 실행하자 30건이 모두 접수됐어요. 같은 주문의 중복 작업 30개로 바꾸면 접수는 한 건이었어요. 중복 방지는 작동했지만, 번호별 집중 발송 제한이 빠져 있었던 거예요.

이 재현은 시간을 고정한 테스트예요. 실제 고객에게 30통이 도착했다는 운영 기록이나 도착 속도 측정은 아니에요.

발송 직전에 두 가지 질문을 했어요

기존 규칙은 ‘이 주문의 이 안내를 이미 접수했는가’였어요. 여기에 ‘이 번호로 최근 얼마나 접수했는가’를 추가했어요.

검사 단위막으려는 상황처리
주문·안내 단계같은 안내의 동시 접수와 반복 실행기존 시도를 확인하고 추가 접수 차단
수신번호·짧은 간격서로 다른 주문의 문자가 연달아 접수됨다음 접수 가능 시각까지 대기
수신번호·누적 건수여러 주기에 걸친 과다발송확인 대기로 전환

검사는 PostgreSQL의 발송 잠금 안에서 수행해요. 최근 이력을 확인하고 접수 예정 시도를 저장한 뒤 외부 발송사를 호출해요. 검사와 기록 사이에 다른 작업이 끼어들어 같은 여유분을 동시에 쓰지 못하도록 한 거예요.

번호의 공백·하이픈·국가번호 표기를 정규화하고, 제작사진·배송완료 안내·후속 사진을 같은 번호의 이력으로 합산해요. 실패나 결과 불명으로 끝난 접수 시도와 수동 재시도 이력도 포함해요. 성공 건만 세면 재시도로 제한을 빠져나갈 수 있기 때문이에요.

기다리면 되는 건과 확인해야 하는 건

이 프로젝트에 적용한 값은 최소 2분 간격, 최근 1시간 4건, 최근 24시간 8건이었어요. 모든 서비스에 그대로 적용하는 기준이 아니라, 이 업무에서 채택한 발송 정책이에요.

간격 제한에 걸린 작업은 다음 접수 가능 시각을 따로 기록해요. 고객과 정한 원래 예약시각은 바꾸지 않아요. 반면 누적 상한을 넘으면 확인 대기로 남기고, 시간이 지나도 그 작업을 자동으로 다시 풀지 않아요.

상황다음 행동
앞선 문자 접수 후 2분이 지나지 않음간격 대기 후 조건 재확인
최근 1시간 또는 24시간 상한 초과관리자 확인 전까지 보류
과거 시도 시각이 잘못 기록됨이력 확인 필요로 보류
다른 번호의 정상 작업자기 번호의 이력으로 별도 판단

1시간과 24시간은 자정에 초기화되는 일별 집계가 아니라 현재 시각에서 거슬러 올라가는 구간이에요. 이력은 데이터베이스에 남기므로 재시작이나 자동발송 OFF→ON으로 초기화되지 않아요.

번호 하나의 대기 작업이 다른 번호까지 막지 않도록 배치 후보를 고르기 전에 대기·보류를 먼저 분류했어요. 다만 이 사전 분류를 발송 허가로 사용하지는 않아요. 실제 접수 직전 잠금 안에서 다시 확인해요.

예외 승인은 선택한 한 건에만 적용했어요

정상적인 단체 주문이라면 관리자가 확인 후 한 건을 예외 승인할 수 있어요. 승인은 30분 동안 유효하고, 해당 작업·주문·연락처·버전·안내 단계에 연결돼요. 내용이 바뀌거나 한 번 사용하면 그대로 재사용하지 못해요.

예외로 풀리는 것은 누적 상한뿐이에요. 최소 간격, 같은 주문의 중복 방지, 연락처와 시트 재확인, 발송 제외, 운영시간은 유지해요. 승인 버튼 자체가 문자를 즉시 보내거나 자동발송을 켜는 것도 아니에요. 워커가 다른 조건을 다시 확인한 뒤 처리해요.

이렇게 해야 ‘이번 주문은 정상’이라는 판단이 이후 모든 발송을 허용하는 설정으로 번지지 않아요.

응답을 모를 때는 다시 보내지 않았어요

외부 발송 요청이 시간 초과로 끝나도 실제 접수가 실패했다고 단정할 수는 없어요. 그래서 요청 전에 submitting 시도를 저장하고, 결과가 불명확하면 uncertain으로 남겨 자동 재접수를 막아요.

발송사의 접수 성공과 전달 성공도 분리해요. 접수 후에는 결과 조회를 이어가고, 전달 성공을 확인한 뒤 시트에 기록해요. 시트 쓰기만 실패하면 문자 발송 단계로 돌아가지 않고 기록만 재시도해요.

이는 외부 통신망까지 포함한 ‘정확히 한 번 도착’을 보장하는 구조는 아니에요. 애플리케이션이 이미 접수했을 수 있는 요청을 무작정 다시 제출하지 않도록 경계를 둔 방식이에요.

이후 카카오·네이버 안내를 연결하면서는 확정 실패에만 문자로 전환하는 경로가 추가됐어요. 수신번호 제한과 별도로, 외부 응답에서 실패와 결과 불명확을 구분하는 문제가 있었어요. 실제 응답 분류 누락을 재현하고 기존 이력 안에서 문자 전환을 복구한 과정에 따로 정리했어요.

재현 조건을 그대로 두고 다시 검증했어요

보강 뒤 같은 번호의 서로 다른 주문 30건을 동시에 요청했을 때 첫 접수는 한 건이었어요. 시간을 진행시키며 2분 이상 간격으로 총 네 건이 접수됐고, 나머지 26건은 확인 대기로 남았어요. 두 시간이 지난 뒤에도 보류 건은 자동으로 재개되지 않았어요.

독립 PostgreSQL 연결의 동시 요청, 국가번호 표기 차이, 수동 재시도 이력, 재시작, 승인 만료와 재사용, 다른 번호의 처리도 검증했어요. 이때 확인한 간격은 서버의 접수 시도 시작 시각 기준이며 실제 휴대폰 도착 간격과는 달라요.

중복 방지를 검토할 때는 ‘한 작업이 몇 번 실행되는가’에 더해 ‘한 고객이 여러 작업을 통해 무엇을 받는가’도 봐야 했어요. 주문이 모두 정상이어도 수신자가 경험하는 반복은 별도의 문제였어요.