...
Eroare System Design · Rate limiting: 429 și cereri respinse

429 Too Many Requests

Pe scurt

Clientul a trimis mai multe cereri decât permite limita serverului într-un interval, iar rate limiter-ul le respinge pe cele în plus. Ca utilizator al unui API, încetinește și respectă `Retry-After`; ca proprietar, verifică dacă limita e potrivită pentru traficul legitim și dacă se aplică pe client, nu global.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

429 este răspunsul standard al unui rate limiter: „ai depășit numărul de cereri permis”. De obicei vine cu antete care spun limita și când poți reveni: Retry-After: 30, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Dacă primești 429 de la un API extern, codul tău trimite prea repede: o buclă fără pauză, reîncercări imediate, mai multe instanțe care împart aceeași cheie. Soluția este să respecți Retry-After, să reîncerci cu backoff exponențial și să grupezi cererile.

Dacă utilizatorii tăi legitimi primesc 429, limita ta e greșită: prea mică pentru traficul real, aplicată global în loc de per utilizator, sau numărată pe IP când mulți utilizatori ies prin același NAT. Rate limiting-ul protejează sistemul de abuz, dar nu trebuie să respingă traficul normal; limita se alege din capacitatea reală a sistemului și din traficul observat.

De ce apare: cauzele frecvente

1Limită globală mai mică decât traficul legitim

Greșit
limit_req_zone $server_name zone=api:10m rate=500r/s;   # o singură găleată pentru toți
Corect
limit_req_zone $binary_remote_addr zone=per_ip:10m rate=20r/s;
limit_req zone=per_ip burst=40 nodelay;
limit_req_status 429;

Limita globală respinge utilizatori normali când crește traficul total. Limita per client oprește doar pe cel care abuzează.

2Client care reîncearcă imediat după 429

Greșit
while (true) {
  const r = await fetch(url);
  if (r.status !== 429) return r;
}
Corect
for (let i = 0; i < 5; i++) {
  const r = await fetch(url);
  if (r.status !== 429) return r;
  const s = Number(r.headers.get('Retry-After')) || 2 ** i;
  await new Promise((ok) => setTimeout(ok, s * 1000));
}

Reîncercarea imediată adaugă cereri exact când serverul cere mai puține. Așteptarea indicată (sau backoff exponențial) le lasă să treacă.

Repară tu

Repară eroarea, direct în pagină

După o reclamă, magazinul are 1.500 de citiri pe secundă legitime, iar sistemul le duce ușor. Rate limiter-ul are însă limita de 500 de cereri pe secundă în total și răspunde cu 429 la majoritatea clienților. Ajustează limita astfel încât traficul legitim să treacă integral, dar să rămână o protecție de cel mult 3.000 de cereri pe secundă.

Indiciu

Limita trebuie să fie peste traficul legitim și sub capacitatea sistemului.

Alte forme ale mesajului

  • HTTP 429 Too Many Requests
  • Rate limit exceeded
  • API rate limit exceeded for 203.0.113.5.
  • TooManyRequestsException: Rate exceeded

Cum o eviți pe viitor

  • Alege limitele din capacitatea măsurată a sistemului și din traficul real, cu marjă.
  • Aplică limita per utilizator sau per cheie de API, nu global.
  • Trimite Retry-After și antetele X-RateLimit-*, ca clienții să se poată adapta.
  • În clienți, folosește backoff exponențial cu jitter și o limită de încercări.

Întrebări frecvente

429 sau 503 când serverul e supraîncărcat?

429 spune unui client anume că el a depășit limita lui. 503 spune tuturor că serviciul nu poate răspunde acum. Pentru supraîncărcare generală, 503 cu Retry-After e mai corect.

De ce primesc 429 deși trimit puține cereri?

Limita poate fi pe IP, iar alți utilizatori din aceeași rețea (firmă, VPN, CGNAT) consumă din aceeași găleată. Sau mai multe instanțe ale aplicației tale folosesc aceeași cheie de API.

Erori înrudite

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață System Design de la zero, cu exerciții la fiecare lecție

Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.