48강 목차 / AI 실전개발 / 8강
PRACTICAL AI DEVELOPMENT · LESSON 08 / 24
처음 개발하는 수강생을 위한 단계별 설명

서버 알림이 두 번 오면 어떻게 해야 할까?

결제 서비스 알림이 네트워크 때문에 두 번 오면 같은 결제를 두 번 기록할 수 있습니다.

이 강의가 끝나면 내가 할 수 있는 일같은 이벤트가 여러 번 와도 처리 결과를 한 번만 반영한다.
01 · 무슨 내용을 배우나요?

기술 이름보다 해결할 문제를 먼저 살펴보겠습니다

결제 서비스 알림이 네트워크 때문에 두 번 오면 같은 결제를 두 번 기록할 수 있습니다.

AI 개발이라고 해서 처음부터 모든 기능을 한 번에 코딩하는 것은 아닙니다. 이번 시간에는 같은 이벤트가 여러 번 와도 처리 결과를 한 번만 반영한다.를 이해하고, 화면·입력·서버가 어떤 순서로 움직이는지 작은 예제로 확인해 보겠습니다.

강사의 설명

먼저 아래 상황을 읽어보세요. 어떤 정보가 들어오고 무엇이 정상적인 결과인지 알면 코드를 처음 봐도 이해하기 쉬워집니다. 모르는 전문용어는 아래 ‘쉬운 용어 설명’을 열어 확인하세요.

오늘 사용할 가상 상황·입력

event_id=evt_demo_01 / status=paid
event_id=evt_demo_01 / status=paid (재수신)

코드와 자료는 교육용 축약 예시입니다. 실제 운영 적용 전 추가 보안·예외 처리·환경 설정이 필요할 수 있습니다.

02 · 강사가 한 번 보여드립니다

이런 코드 또는 설계 규칙으로 처리합니다

아래 내용을 글자 그대로 외우기보다 어떤 정보를 입력받고, 어떤 규칙을 검사하며, 무엇이 반환되는지 먼저 살펴보세요.

교육용 코드·설계 입력 예시
처리 규칙 예시:
서명 확인
이벤트 ID 중복 검사
처리 이력 없으면 1회 반영
이미 처리했다면 추가 변경 없이 기록

정상일 때 기대하는 결과

설명용 예상 결과 · 실행·배포를 완료했다는 의미가 아닙니다
첫 이벤트: 처리 1회
재수신: 중복으로 표시
총 상태 변경: 1회
강사의 해설

가장 중요한 것은 외형보다 입력과 결과 사이의 규칙입니다. 빈 입력, 권한 부족, 중복 요청처럼 예외가 생겨도 문제가 없는지 확인해야 합니다. 이 예제 하나를 이해하면 다른 기능도 비슷한 방식으로 나눠 볼 수 있습니다.

03 · 잘못 만들면 어떤 문제가 생기나요?

실수 사례와 개선 방법을 나란히 비교합니다

✕ 피해야 할 구현

요청을 받을 때마다 데이터베이스 상태를 다시 변경합니다.

✓ 개선할 방법

고유 이벤트 ID를 원자적으로 기록하고 재수신을 무해하게 처리합니다.

전문용어 두 개를 쉬운 말로 알아보기
웹훅
특정 사건이 발생했음을 다른 서비스에 알리는 요청
멱등성
같은 요청을 여러 번 해도 최종 상태가 달라지지 않는 성질
04 · 직접 따라 해보세요

세 단계의 미니 개발 실습

운영 서버가 아니라 로컬 실습 또는 별도의 연습 환경에서 수행합니다. 필요한 외부 계정이나 운영 데이터는 사용하지 않습니다.

  1. STEP 1가상 이벤트 두 개를 비교한다.
  2. STEP 2같은 ID를 한 번만 처리하는 규칙을 만든다.
  3. STEP 3실패와 재시도를 구분하는 로그를 설계한다.
내가 만든 결과 기록하기

실습으로 확인한 입력, 정상 결과, 오류 결과와 수정할 항목을 적어보세요.

과제 완료 기준
05 · 이해했는지 확인해 보세요

오늘 수업의 핵심 질문

같은 알림이 두 번 오면 성공 응답 두 번을 보내도 데이터도 두 번 바꿔야 할까요?

정답과 이유 펼쳐보기

아닙니다. 동일 이벤트는 한 번만 처리해야 합니다.

수강생이 제출할 결과물중복방지 웹훅 의사코드

단순히 붙여 넣은 코드보다 작동 원리와 오류 처리 방법을 자신의 말로 설명하는 것이 중요합니다.

기존 LEXID·RE:LAND 등에서 검증한 개발 구조를 학습용으로 재구성했습니다. 비공개 저장소의 실제 고객 데이터나 비밀키는 공개하지 않습니다. 예시는 운영용 완제품이 아닙니다.