Skip to content

Latest commit

 

History

History
124 lines (97 loc) · 8.56 KB

S6_HTTP_MOCK.md

File metadata and controls

124 lines (97 loc) · 8.56 KB

S6 첫 단계: 별도 HTTP Mock 공급자

현재 범위

src/mockServer에 독립 Spring Boot HTTP 서버를 추가했다. 로컬 H2 파일에 멱등성 기록을 보관하며 MySQL·Kafka와 독립적으로 실행된다. 기본 알림 앱과 Worker는 JVM 내부 MockPushProvider를 사용한다. app.provider.mode=HTTP로 timeout·연결 풀 상한을 가진 HTTP 어댑터를 선택할 수 있다. 이번 서버의 요청 한도는 공급자 측 장애 재현용이며, 아직 Redis 전역 Rate Limit이나 Worker 보호 장치가 아니다.

기본 주소는 127.0.0.1:18081. 별도 source set·패키지·설정 파일을 사용하며 알림 앱 JAR에는 포함하지 않는다. HTTP Mock JAR에도 알림 앱의 API/Worker/Relay 클래스는 포함하지 않는다. 의존 라이브러리는 기존 Boot BOM을 공유한다.

실행

Java 21과 로컬 저장 경로의 쓰기 권한이 있으면 실행할 수 있다.

./gradlew mockServer
# 별도 실행 파일 생성/기동
./gradlew mockServerJar
java -jar build/libs/notification-lab-0.3.0-SNAPSHOT-http-mock.jar

./gradlew build도 두 JAR와 일반 테스트를 함께 만든다. 일반 테스트 전체는 기존처럼 Docker가 필요하다.

curl -i http://127.0.0.1:18081/pushes \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 00000000-0000-0000-0000-000000000001' \
  -d '{"notificationId":"00000000-0000-0000-0000-000000000001","recipientId":"synthetic-user","title":"테스트","body":"가상 데이터"}'
curl http://127.0.0.1:18081/actuator/health
curl http://127.0.0.1:18081/mock/config
curl http://127.0.0.1:18081/mock/stats

202 응답은 {"providerMessageId":"http-mock-..."}다. Mock 수락이며 단말 도착이 아니다. 같은 키와 본문을 다시 보내면 첫 providerMessageId를 반환한다. 재시작하면 프로세스별 요청·수락 집계와 요청 한도가 초기화되며, 같은 파일에서 이전 수락 기록을 다시 읽는다.

실패·지연 설정

설정은 기동 시 적용하며 바꾸려면 서버를 종료한 뒤 새 설정으로 실행한다.

./gradlew mockServer --args='--mock.http.mode=TOO_MANY_REQUESTS'
./gradlew mockServer --args='--mock.http.mode=SERVER_ERROR'
./gradlew mockServer --args='--mock.http.mode=INVALID_RECIPIENT'
./gradlew mockServer --args='--mock.http.response-delay-ms=2000'
./gradlew mockServer --args='--mock.http.requests-per-window=3 --mock.http.window-ms=1000'
설정 기본값 허용 범위/의미
server.port 18081 개발용 포트. 테스트는 임의 포트 0
mock.http.mode SUCCESS SUCCESS / TOO_MANY_REQUESTS / SERVER_ERROR / INVALID_RECIPIENT
mock.http.response-delay-ms 100 0~10,000ms. 수락/실패 결정을 기록한 뒤 응답을 지연
mock.http.requests-per-window 100 1~10,000. 서버 한 프로세스 전체의 새 요청 한도
mock.http.window-ms 1000 100~60,000ms. monotonic clock으로 측정하는 고정 윈도우
mock.http.max-in-flight 4 1~8. 응답 지연 중인 처리 수 상한
mock.http.idempotency-capacity 1,100,000 1~1,100,000. 저장 파일에 보관할 키의 상한
mock.http.idempotency-file ./.mock-data/acceptances 실행 디렉터리 기준 H2 파일 경로. H2가 .mv.db 확장자를 붙인다.
조건 응답 errorCode
정상 수락 202 없음, providerMessageId 반환
강제 429 또는 윈도우 한도 초과 429 + Retry-After MOCK_RATE_LIMITED
강제 서버 실패 500 MOCK_UNAVAILABLE
강제 수신자 영구 실패 400 MOCK_INVALID_RECIPIENT
동시 처리 슬롯 소진 503 MOCK_BUSY
잘못된 JSON/필수 값·길이 오류 400 MOCK_INVALID_REQUEST
키가 알림 ID와 다르거나 여러 개 400 MOCK_INVALID_IDEMPOTENCY_KEY
이미 수락한 키와 다른 본문 409 MOCK_IDEMPOTENCY_CONFLICT
키 저장 한도에 도달한 뒤 새 키 사용 503 MOCK_IDEMPOTENCY_CAPACITY
실행 중 멱등성 저장소 읽기·쓰기 오류 503 MOCK_IDEMPOTENCY_STORAGE_UNAVAILABLE
8KiB 초과 JSON 본문 413 MOCK_PAYLOAD_TOO_LARGE

강제 429의 Retry-After는 1초, 한도 초과는 현재 윈도우 잔여 시간을 초 단위로 올림한다. 수신자 100자, 제목 100자, 본문 500자 상한과 UUID 형식을 검사한다. Content-Length가 없는 요청도 8KiB 상한을 적용한다. 잘못된 요청과 수락 결과 재조회는 한도를 소비하지 않는다. 새 유효 요청은 먼저 윈도우 한도를 소비하고 이후 슬롯/설정 결과를 적용하므로 500·강제 429·busy도 한도 안에 들어온 시도라면 예산을 소비한다.

timeout은 응답 실패와 다르다

SUCCESS + 응답 지연 2000ms로 실행한 서버에 아래처럼 0.2초 제한을 두면 클라이언트가 timeout을 경험할 수 있다.

curl --max-time 0.2 -i http://127.0.0.1:18081/pushes \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 00000000-0000-0000-0000-000000000001' \
  -d '{"notificationId":"00000000-0000-0000-0000-000000000001","recipientId":"synthetic-user","title":"timeout","body":"가상 데이터"}'
curl http://127.0.0.1:18081/mock/stats

서버는 응답 전에 수락을 기록한다. 클라이언트 timeout이나 연결 종료가 이미 기록한 수락을 취소하지 않는다. HTTP 공급자 어댑터는 재처리에도 알림 UUID를 Idempotency-Key로 보낸다. Mock은 같은 키와 본문을 받으면 최초의 providerMessageId를 즉시 반환한다. 신규 수락은 UUID 기본 키, 본문 SHA-256, 공급자 ID를 H2에 저장하고 디스크 동기화를 완료한 뒤 기록한다. 용량이 차면 기존 키를 유지한 채 새 키를 거부한다. 헤더를 생략한 직접 호출은 건별로 처리한다. HTTP 멱등성 키 설계 초안 · H2 동기화 명령

재시작할 때 같은 파일을 사용해야 이전 수락 기록을 복구할 수 있다. Mock 프로세스 하나가 파일 하나를 소유한다. 시작할 때 파일을 열 수 없으면 서버 시작이 실패한다. 실행 중 저장소 오류가 나면 키가 있는 요청에 503을 반환한다. 무한히 응답하지 않는 서버 대신 최대 10초의 유한 지연을 사용한다.

상한과 집계 해석

Tomcat 스레드 16, 연결 32, accept backlog 16으로 설정했다. Mock 처리 슬롯은 기본 4이며 슬롯 대기는 하지 않고 503을 반환한다. 연결 한도까지 초과하는 부하에서는 HTTP 응답 전에 연결 거절/timeout이 생길 수 있다. 모든 과부하에 503을 보장하지 않는다.

/mock/stats의 requests는 유효한 호출 수, accepted는 처음 수락한 건수, idempotencyReplays는 기존 수락 결과를 돌려준 횟수다. storedAcceptances는 이전 실행에서 복구한 키를 포함한 저장 건수다. 나머지 요청 카운터는 프로세스 단위로 집계한다. active는 지연을 포함한 현재 처리 수, maxActive는 기동 후 관찰한 최고 동시 처리 수다. 수락된 응답이 클라이언트에 도달했다는 뜻은 아니다. 카운터에는 요청과 수신자 ID를 label로 넣지 않는다. 동시 실행 중 snapshot의 각 필드는 순간적으로 어긋날 수 있으므로 정확한 대조는 요청이 끝난 뒤 한다.

고정 윈도우 경계 양쪽에는 짧은 시간에 두 윈도우의 한도가 몰릴 수 있다. 장기 미사용 예산을 누적하지 않는다. 서버를 여러 개 띄우면 각각 별도 한도를 가진다. 실제 FCM/APNs 쿼터나 전역 속도 제어 보장이 아니다. 이후 Redis/Worker 보호 실험에서 공급자 한도를 지키는지 측정할 대상이다.

검증과 다음 단계

./gradlew test --tests 'dev.jinhyeon.notificationmock.*'
./gradlew build --rerun-tasks

실제 HTTP의 202/429/500/400, 동시 한도, 처리 슬롯, timeout 후 수락 유지, 잘못된 입력/큰 본문, 설정 상한과 monotonic 윈도우 리필을 검증한다. 상세 실행 결과는 PROGRESS에 기록한다. 후속 단계에서 HTTP 어댑터, Worker 동시성 상한, Redis quota, pause/resume, Circuit Breaker를 연결했다. Redis 장애/예산 유실 정책까지 추가했다. 역할별 자원·예약 예산도 추가했다. 캠페인 생성/Batch는 S7 범위다.