HTTP 429와 Retry-After, 요청 제한 응답을 읽고 재시도를 조절하기

페이지 정보

profile_image
작성자 관리자
댓글 0건 조회 251회 작성일 26-10-13 07:18

본문

외부 API를 호출하다 HTTP 429 응답을 받으면 코드를 다시 실행해 보는 것부터 떠올리기 쉽습니다. 하지만 같은 요청을 즉시 반복하면 제한을 더 오래 겪거나 불필요한 요청을 늘릴 수 있습니다.

429는 일정 시간 동안의 요청이 너무 많다는 응답이며, 실제 제한 단위와 회복 조건은 서비스마다 확인해야 합니다. 이 글은 제한을 우회하는 방법이 아니라 응답 정보와 공식 사용 조건을 읽고 클라이언트의 요청 속도와 재시도를 조절하는 기본 개념을 설명합니다.

대기 중인 나무 말과 모래시계로 요청 대기를 비유한 AI 이미지

AI 생성 삽화 · 개념 이해를 위한 AI 연출 이미지이며 실제 시스템 구성도나 측정 결과가 아닙니다.

핵심 정리
429 응답에서는 상태 코드, 본문 안내, Retry-After와 서비스의 제한 정책을 함께 읽습니다. 기다린 뒤 무조건 성공한다고 가정하지 말고 재시도 횟수·전체 대기시간·동시 요청 수를 함께 관리합니다.


1. 429는 요청 제한을 알리지만 제한 단위를 정해 주지는 않습니다

RFC 6585는 429를 일정 시간 동안 너무 많은 요청을 보냈을 때의 상태 코드로 정의합니다. 그러나 어떤 사용자를 어떻게 식별하고 요청을 어떤 범위로 세는지는 이 코드 자체가 정하지 않습니다.

계정, 인증 정보, 특정 자원 등 제한의 실제 기준은 서비스 문서를 확인해야 합니다. 한 작업자가 요청을 적게 보냈어도 여러 작업자가 같은 제한 범위를 공유한다면 합계가 영향을 줄 수 있습니다.

반대로 특정 경로에만 적용되는 제한을 전체 서비스의 사용 불가 상태로 해석해서도 안 됩니다. 본문에 제공되는 오류 코드나 설명은 원인을 좁히는 데 도움이 되므로 상태 숫자만 기록하지 않습니다.

인증 실패나 서버 장애를 나타내는 다른 응답과도 구분해야 합니다. 단, 서비스마다 세부 오류 체계가 있으므로 일반적인 설명을 해당 API의 정확한 정책으로 대신하지 않습니다.

제한을 받았다는 사실을 알았다면 먼저 현재의 요청 흐름과 공유 범위를 확인합니다.

관련 공식 문서


2. Retry-After는 선택적으로 제공되는 대기 안내입니다

429 응답에는 Retry-After 헤더가 포함될 수 있지만 항상 있어야 하는 것은 아닙니다. 이 헤더가 있으면 다음 요청 전에 기다릴 시점이나 시간을 해석할 수 있습니다.

RFC 9110은 값의 형식으로 HTTP 날짜와 응답을 받은 뒤 지연할 초 단위 정수를 설명합니다. 예를 들어 Retry-After: 45라면 숫자를 밀리초가 아닌 초로 읽어야 합니다.

날짜 형식이라면 문자 그대로 숫자로 변환하지 말고 HTTP 날짜로 해석해야 합니다. 이 값은 기다린 뒤의 성공을 보장하는 예약권은 아닙니다.

같은 제한을 공유하는 다른 요청이나 서버 상태에 따라 다시 제한될 수 있습니다. 헤더가 없거나 해석할 수 없는 경우를 코드에서 구분하고 해당 서비스의 재시도 지침을 확인합니다.

잘못된 값을 받았다고 즉시 반복 호출하는 기본 동작으로 이어지지 않도록 정책을 정하는 것이 좋습니다. 헤더의 존재 여부와 실제 적용한 대기시간을 로그에 남기면 동작을 검토하기 쉽습니다.

관련 공식 문서


3. 원래 요청과 재시도를 합쳐 부하를 봅니다

가상의 배치 작업에서 작업자 다섯 개가 동시에 같은 API를 호출한다고 생각해 봅니다. 한 작업자만 보면 호출 간격을 지켰어도 전체 요청은 짧은 시간에 몰릴 수 있습니다.

각 작업자가 실패할 때마다 다시 보내면 최초 요청보다 실제 호출 수가 많아집니다. 여기에 SDK의 자동 재시도와 애플리케이션 재시도가 겹치면 개발자가 예상한 횟수보다 더 많은 시도가 생길 수 있습니다.

따라서 재시도를 어디에서 책임질지 정하고 이미 제공되는 클라이언트 동작을 확인해야 합니다. 요청 제한을 만났을 때 새로운 작업의 유입도 계속되는지 살펴봅니다.

실패한 요청만 늦추고 새 요청은 같은 속도로 밀어 넣으면 전체 부담이 줄지 않을 수 있습니다. 동시 실행 수와 처리 속도를 함께 조정할 수 있도록 작업 큐와 요청 호출 지점을 구분합니다.

계정이나 연결을 바꾸어 제한을 피하려는 방식 대신 허용된 범위 안에서 처리 계획을 맞추는 것이 기본입니다.

관련 공식 문서


4. 백오프와 지터는 재시도 시점을 분산하는 수단입니다

백오프는 반복 실패에 따라 다음 시도까지의 대기 간격을 조절하는 방식입니다. 지터는 여러 클라이언트가 같은 시점에 재시도하지 않도록 대기시간에 무작위성을 더하는 방법입니다.

AWS의 재시도 안내는 같은 시간에 다시 몰리는 현상을 줄이기 위해 지터를 설명합니다. 다만 지터를 넣었다고 서버가 안내한 대기시간보다 일찍 보내도 된다는 뜻은 아닙니다.

Retry-After와 서비스 정책을 해석한 뒤 그 조건을 지키는 범위에서 재시도 시점을 정해야 합니다. 모든 API에 사용할 수 있는 하나의 고정 공식이 있다고 가정하지 않습니다.

공식 SDK가 권장 동작을 제공한다면 중복 구현 전에 설정과 동작을 확인합니다. 대기 간격뿐 아니라 최대 시도 횟수와 전체 처리 기한도 정합니다.

계속 기다릴 가치가 없는 작업은 보류하거나 실패로 반환할 수 있어야 하며, 사용자 화면에서도 성공한 것처럼 표시하지 않아야 합니다.

관련 공식 문서

관련 공식 문서


5. 읽기 요청과 상태를 바꾸는 요청의 재시도를 구분합니다

재시도 정책은 429를 처리하는 방법뿐 아니라 해당 요청의 성격도 고려해야 합니다. 조회 요청과 주문 생성처럼 상태를 바꾸는 요청을 같은 코드로 무조건 반복하지 않습니다.

특히 응답을 받지 못한 타임아웃과 명시적으로 받은 429 응답을 같은 상황으로 뭉뚱그리면 결과 확인이 어려워집니다. 서비스가 멱등성 키나 요청 상태 조회를 제공하는지 공식 문서에서 확인할 수 있습니다.

어떤 작업이 실제로 수행되었는지 불명확한 경우에는 가능한 상태 확인 절차를 거친 뒤 재시도를 판단합니다. 이 글의 일반 설명만으로 특정 API의 처리 완료 여부를 단정할 수는 없습니다.

재시도할 때 새 요청 식별자를 매번 만드는 것이 맞는지도 서비스의 의미에 따라 확인해야 합니다. 최종 결과를 사용자에게 전달할 때에는 완료, 보류, 실패를 구분합니다.

내부에서 몇 번 시도했는지와 업무가 몇 번 실행되었는지를 따로 추적할 수 있는 기록이 필요합니다.

관련 공식 문서


6. 로그와 작은 시나리오로 정책을 검증합니다

재시도 테스트는 실제 서비스에 요청을 과도하게 보내기보다 제어된 응답을 반환하는 테스트 환경에서 구성할 수 있습니다. 숫자형 Retry-After, 날짜형 값, 헤더 없음, 연속된 429와 이후 성공을 각각 확인합니다.

전체 처리 기한을 넘는 대기 안내가 왔을 때 어떻게 종료하는지도 점검합니다. 로그에는 상태 코드, 시도 번호, 다음 대기시간, 요청 식별자와 적용한 정책을 남길 수 있습니다.

인증 토큰이나 개인정보가 포함된 요청 본문을 그대로 기록하지 않도록 주의합니다. 운영에서는 429 비율만 보지 말고 최종 성공률과 대기시간, 포기한 작업 수를 함께 살펴봅니다.

가상의 작업 두 개가 같은 시점에 제한을 받았을 때 다시 같은 순간에 호출되는지도 확인할 수 있습니다. 테스트의 목적은 제한 응답을 숨기는 것이 아니라 의도한 속도로 멈추고 다시 시작하는지 확인하는 것입니다.

제한이 반복되면 작업량과 서비스 사용 조건을 재검토하고 필요한 조정을 정식 절차로 요청합니다.


7. 자주 묻는 질문

Q1. Retry-After가 없으면 바로 다시 호출해도 됩니까?

헤더가 없다는 사실은 즉시 재시도를 허용한다는 뜻이 아닙니다. 해당 서비스의 공식 정책을 확인하고 최대 횟수와 대기시간이 있는 재시도 방식을 적용해야 합니다.

Q2. Retry-After: 45는 45밀리초입니까?

초 단위 정수이므로 이 예시는 45초를 뜻합니다. 값이 날짜 형식일 수도 있으므로 숫자형과 날짜형을 구분해서 해석해야 합니다.

Q3. 한 작업자만 요청을 줄이면 제한이 풀립니까?

여러 작업자가 같은 제한 범위를 공유한다면 전체 요청을 함께 봐야 합니다. 서비스가 무엇을 기준으로 제한하는지 확인하고 최초 요청과 재시도를 합친 속도와 동시 실행 수를 조절합니다.

Q4. 대기 후 다시 429가 나오면 구현이 틀린 것입니까?

기다렸다고 다음 요청의 성공이 보장되는 것은 아닙니다. 제한 범위와 다른 요청의 영향, 실제 대기 동작을 확인하고 정해 둔 재시도 한도나 전체 기한에 따라 보류·실패 처리를 진행합니다.


참고 자료

댓글목록

등록된 댓글이 없습니다.