지니로그

인사이트

노출 기간이 있는 데이터는 클라이언트에서 다시 판정하지 마라

이 글은 한국어로만 있습니다

노출 기간(start~end)이 있는 데이터의 '지금 보일지'는 서버의 단일 시계로만 판정하고, 클라이언트는 재판정하지 않는다. 브라우저 시계는 사용자가 바꿀 수 있어 틀어져 있으면 항목이 조용히 사라지고, 이 버그는 시계가 정확한 개발자 기기에서 재현되지 않는다. 서버가 이미 걸러 내려주므로 클라이언트의 start/end 필드는 '표시용'으로만 쓴다.

무엇을 알게 됐나

노출 기간(start~end)이 있는 데이터의 “지금 보일지”는 서버 한 곳에서만 판정하고, 클라이언트는 다시 거르지 않는다. 클라이언트가 브라우저 시각으로 재판정하면, 시계가 틀어진 사용자에게만 항목이 조용히 사라지는 버그가 생긴다.

어떤 상황이었나

로그인 화면 공지 팝업을 만들 때였다. 서버는 “지금 띄울 공지”만 골라 내려줬고, 각 공지에는 notice_start_at·notice_end_at 시각도 함께 담겨 있었다. 클라이언트에서 “혹시 기간이 지난 게 섞여 있을까 봐” 현재 시각과 두 필드를 비교해 한 번 더 필터링하는 코드를 넣으면, 시계가 정확한 QA·개발 기기에서는 멀쩡하고 시계가 틀어진 일부 사용자에게만 공지가 안 뜬다. 재현이 안 되니 원인 추적도 어렵다.

왜 그런가

브라우저 시계는 신뢰할 수 없는 입력이다. 사용자가 직접 바꿀 수 있고, 실제로 몇 분에서 며칠씩 틀어져 있는 기기가 존재한다. 반면 서버는 DB의 단일 시계로 판정하므로 모든 사용자에게 같은 결과를 준다.

클라이언트가 기간을 다시 판정하는 순간 판정 기준이 되는 시계가 둘이 된다. 서버 시계와 브라우저 시계가 어긋나면 두 판정이 갈리고, 최종 화면은 더 못 믿을 브라우저 시계 쪽을 따른다. 서버가 이미 “지금 보일 것”만 걸러 내려줬다면, 클라이언트의 start/end는 판정용이 아니라 화면에 기간을 표시하는 용도로만 써야 한다.

언제 적용되고 언제 안 되나

적용된다 — 서버가 판정할 수 있는 노출 규칙: 공지·배너 노출 기간, 예약 게시, 쿠폰 유효기간처럼 “지금 유효한가”를 서버가 알 수 있는 경우. 서버가 유효한 것만 내려주고 클라이언트는 표시만 한다.

안 된다 / 예외:

  • 순수 표시용 카운트다운 UI(다음 갱신까지 남은 시간 등)는 클라이언트 시계로 계산해도 된다. 판정이 아니라 표시이기 때문이다. 단 “만료되면 버튼 비활성화” 같은 판정이 붙는 순간 다시 서버(또는 서버가 내려준 만료 여부 플래그)로 옮긴다.
  • 오프라인 우선 앱은 서버에 매번 물을 수 없어 별도의 시각 동기화 전략이 필요하다. 이 글의 범위 밖이고, 오프라인 환경에서의 최적해는 확인하지 못했다.

정리

구분판정 주체신뢰하는 시계클라이언트 역할
노출 기간 판정서버서버 DB 시계서버가 준 것만 표시
start/end 필드——기간 “표시”에만 사용, 재필터 금지
카운트다운 표시클라이언트브라우저 시계표시 계산만, 판정 없음

시간처럼 환경마다 다른 값은 판정 지점을 하나로 모으는 것이 가장 확실한 방어다. “혹시 몰라서” 클라이언트에 넣는 방어 한 줄이, 재현 안 되는 버그의 원인이 된다.