429 Too Many Requests
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
limit_req_zone $server_name zone=api:10m rate=500r/s; # o singură găleată pentru toțilimit_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
while (true) {
const r = await fetch(url);
if (r.status !== 429) return r;
}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ă 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.
Reparația
1. Atinge Rate limiter. 2. Setează Limită (cereri/s în total) = 2.000.
Rezultat: 0 cereri respinse la trafic normal, protecție păstrată.
De ce merge
Limita de 500 respingea două treimi din clienți normali. Cu limita la 2.000 (între traficul legitim de 1.500 și capacitatea de aproximativ 3.000), clienții trec toți, iar un val de trafic anormal tot e oprit.
Alte forme ale mesajului
HTTP 429 Too Many RequestsRate limit exceededAPI 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 anteteleX-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
Un robot (scraper) trimite mii de cereri pe secundă și oprește site-ul Un scraper, un client cu bug sau un atac trimite mult mai multe cereri decât pot duce serverele, iar utilizatorii normali primesc 502/503. Fără un rate limiter, toate cererile ajung la servere. Pune limitarea în fața load balancer-ului, ca surplusul să fie respins ieftin, cu 429. Rate limiter-ul nu respinge nimic: cererile îl ocolesc direct spre load balancer Ai pus un rate limiter, dar o parte din trafic ajunge la load balancer sau la servere pe altă cale (adresa directă a load balancer-ului, un domeniu vechi, un IP public al serverelor), deci limitarea nu se aplică. Închide toate intrările care nu trec prin limitator. Retry storm: reîncercările fără backoff înmulțesc traficul și țin serviciul căzut La primele erori, toți clienții reîncearcă imediat, de mai multe ori, iar serviciul deja suprasolicitat primește de câteva ori mai mult trafic și nu-și mai poate reveni. Reîncearcă doar erorile temporare, cu backoff exponențial și jitter, cu un număr mic de încercări și un buget de reîncercări. Î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.
