API 재시도 설계 exponential backoff와 rate limit 대응

재시도 횟수와 backoff를 기다림 없이 확인

Node.js 24에서 읽기 요청의 결과를 함수로 주입합니다. 실제 네트워크나 sleep 없이 재시도 정책과 지연값을 확인합니다. 최대 시도 3회에는 첫 요청이 포함되며 POST 재전송이나 Retry-After 파싱을 구현한 범용 클라이언트는 아닙니다.

retry-demo.mjs 전체 코드

async function readWithRetry(request, wait) {
  for (let attempt = 1; attempt <= 3; attempt += 1) {
    const status = await request();
    if (status >= 200 && status < 300) return attempt;
    const transient = status === 429 || status === 503;
    if (!transient || attempt === 3) throw new Error(`HTTP ${status}, 시도 ${attempt}`);
    await wait(100 * 2 ** (attempt - 1));
  }
}
const responses = [503, 503, 200];
const delays = [];
const attempts = await readWithRetry(async () => responses.shift(), async ms => delays.push(ms));
console.log(`시도 ${attempts}, 지연 ${delays.join(',')}`);
try { await readWithRetry(async () => 401, async () => {}); }
catch (error) { console.log(error.message); }
try { await readWithRetry(async () => 503, async () => {}); }
catch (error) { console.log(error.message); }

저장한 폴더에서 node retry-demo.mjs로 실행합니다. 예상 출력은 다음과 같습니다.

시도 3, 지연 100,200
HTTP 401, 시도 1
HTTP 503, 시도 3

직접 바꿔 보기: 응답을 [429, 200]으로 바꾸면 시도 2회·기본 지연 100ms가 나옵니다. 이 최소 예제에는 공급자 Retry-After나 jitter가 없으므로 실제 호출에 그대로 사용하지 말고, 하단 전체 예제에서 대기 상한·헤더 해석·읽기 요청 제한을 비교하세요.