429클라이언트 오류(4xx)
429 Too Many Requests — 요청 과다(레이트 리밋)
짧은 시간에 너무 많은 요청을 보내 서버가 제한(rate limit)을 건 응답입니다. API 호출 폭주·재시도 루프에서 발생합니다.
언제 발생하나
API 분당/시간당 한도 초과, 무한 재시도 루프, 동시 다발 요청, LLM API 토큰·요청 한도 초과에서 발생합니다.
실무 대응
- Retry-After 헤더를 확인해 그 시간만큼 기다린 뒤 재시도합니다.
- 지수 백오프(exponential backoff)와 지터를 넣어 재시도가 한꺼번에 몰리지 않게 합니다.
- 클라이언트 측 요청을 배치·캐시·디바운스로 줄이고, 한도가 낮으면 플랜 상향을 검토합니다.
💡 실무 메모: LLM API 연동에서 흔합니다. 백오프 없이 즉시 재시도하면 429가 더 심해지니 반드시 대기 후 재시도하세요.