백엔드 · 오류·증상

HTTP 429: Too Many Requests

일정 기간에 너무 많은 요청을 보냈다고 서버가 판단해 제한한 HTTP 429 응답을 확인하는 문서입니다.

빠른 답변

우선 확인할 원인: HTTP 429 응답이 반복되면 요청 URL·메서드·응답 상태·발생 시각·Retry-After 헤더 유무를 기록해야 합니다. HTTP 429만으로 어떤 제한 기준이 적용됐는지나 언제 재시도해도 되는지는 단정할 수 없습니다.
먼저 확인할 항목: 요청 URL, HTTP 메서드, HTTP 429 상태와 발생 시각을 기록합니다.

적용 범위: 현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
출처: IETF
출처 확인일: 2026-07-29
최종 검토: 2026-07-29
수정일: 2026-07-29
정정 이력: 2026-07-29 이후 기록 없음
관련 기술: HTTP Status Code

오류·수정 제보

현재 증상

애플리케이션 오류 메시지

먼저 확인할 항목

요청 URL, HTTP 메서드, HTTP 429 상태와 발생 시각을 기록합니다.

응답에 Retry-After 헤더가 있는지와 값을 기록합니다.

같은 사용자·네트워크·작업에서 반복되는 요청인지 확인 가능한 범위에서 기록합니다.

피해야 할 조치

주의

제한을 우회하려고 IP·계정·인증 정보를 바꾸거나 자동 재시도를 늘리지 않습니다.
인증 토큰, 세션 쿠키, 개인 식별 정보는 요청 기록에 포함하지 않습니다.

환경별 원인과 조치

적용 범위

이 문서는 HTTP 429 응답을 확인합니다. 서버가 적용한 제한 기준이나 재시도 정책은 서비스마다 다르므로 상태 코드만으로 판단하지 않습니다.

변경 없이 확인할 항목

요청 URL, HTTP 메서드, HTTP 429 상태와 발생 시각을 기록합니다.
응답에 Retry-After 헤더가 있는지와 값을 기록합니다.
같은 사용자·네트워크·작업에서 반복되는 요청인지 확인 가능한 범위에서 기록합니다.

RFC 6585는 HTTP 429를 일정 기간에 너무 많은 요청을 보낸 상태로 정의하고, 응답에 Retry-After를 포함할 수 있다고 설명합니다. 제한 기준과 사용자 식별 방식은 이 상태 코드만으로 알 수 없습니다.

다음 문서

HTTP 상태 코드의 기본 의미는 HTTP 상태 코드에서 확인합니다.

참고 자료

RFC 6585 - Additional HTTP Status Codes

IETF · 공식 자료 · 확인 범위: HTTP 429는 사용자가 일정 기간에 너무 많은 요청을 보낸 상태를 나타냅니다., 응답은 Retry-After 헤더로 대기 시간을 안내할 수 있습니다., 이 규격은 서버가 사용자를 식별하거나 요청 수를 계산하는 방식을 정의하지 않습니다. · 확인일: 2026-07-29